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About This Manual 


This guide contains the info:vmation necessary for IOA administrators who are responsible 
for customizing and maintaining the IOA family of products .. 


Basic info:vmation about how IOA p:voducts operate is provided in user manuals fo:v each 
product. 


Most administration information for each product is found in the section devoted to that 


p:voduct. However, all IOA administrators should read Sections 1 and· 2' before continuing 
with the rest of this guide. Section 1 contains an overview of the key IOA concepts which 


apply to all IOA p:voducts. Section 2 describes how to customize the IOA environment. 


The sections in this guide are as follows: 


Section 1 
IOA: An Overview 


Overview of the IOA environment and a description of key IOA concepts and components. 


Section 2 
IOA 


How to customize and maintain the IOA environment. 


Sections 3-7 
Customizing and Administering CONTROL-x 


Information· on administrative tasks for each IOA p:voduct. Each section includes 
information on· the p:voduct's New Day processing and wo:vk flow, as well as info:vmation 


about how the relevant p:voduct can be used to perform specific tasks. These sections also 
include information about the structure of relevant files, operator commands, etc. 


Notes 
CONTROL-R is described together with CONTROL-M in Section 3. 


CONTROL-Vis described together with CONTROL-Din Section 4. 


Section 8 
IOA Maintenance 


Information on maintaining and updating IOA products. 


Section 9 
Utilities 


Special features designed to help you perfol.'m specific tasks. This section contains an 
alphabetized reference guide for all available utilities for each IOA p:rioduct. 


Section 10 
Exits 


Information on exits available with each IOA p:voduct which can be used to modify 


ope:vations .. 


Appendix A 


AppendixB 


Appendix C 


AppendixD 


AppendixE 


IOA Application Program Names 


IOA and CONTROL Products Dataset Formatting Utilities 


Modifying IOA Online Facility Commands 


Logical Field Names for the CONTROL-T Repository 


IOA Online Options Cross-Reference 
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Related Publications 


IOA Installation Guide 


A step by step guide to installing IOA products using the IOA Customization' and 
Installation Engine (ICE) application. 


IOA Security Guides 


Step by step guides to implementing security in IOA products using the IOA 


Customization and Installation Engine (ICE) application. Security guides are currently 
available for IOA interaction with RACF, CA-TOP SECRET, and CA-ACF2~ 


User Manuals 


Product-specific· manuals containing comprehensive info11mation1 about the operation and 
implementation of each IOA p11oduct. 


IOA Messages and Codes 


A comprehensive listing and explanation of all IOA messages and codes .. 


We Want to Hear From You 


If you have any comments or opinions regarding this publication, we want to hear them. 
Your feedback will help us imp11ove our documentation to our mutual benefit. Send your 
remarks by email to publications@ddddf.com. Please include the name and version 
number of the publication in your email. 
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Section 1: IOA Concepts and Components 


Introduction 


IOA (Integrated Operations Architecture) is a fully integrated family of products designed 
to help you streamline and automate your mainframe operations. 


IOA pr:ovides you with the capability of implementing unattended, "lights out" operations. 


The IOA family of products share a set 0£ common components and concepts. This section 
contains an introduction to the IOA pr:oducts and the basic concepts and components used 
in IOA processing~ 


IOA Products 


The IOA pvoducts, which can be used to' automatically manage the functioning 0£ an MVS 


data center ar:e: 


CONTROL-M 


CONTROL-R 


CONTROL-D 


CONTROI:rD/PC 


CONTROL-V 


CONTROL-0 


Production Control, System 


Manages and automates setup, scheduling and execution 0£ jobs in your 


MVS data center. 


Automated Job Restart 


Automates activities which must be perfol'med when restarting a failed' 
job, including scratching and uncataloging of datasets created by the 
failed job: 


Output Management System 


Automatically schedules and controls every aspect of report processing 
and distribution, including report decollating, bundling, p:ci.nting, Online 


Viewing and backup; 


Online Viewing and Manipulation of Mainframe and Reports 


Comprehensive output viewing system which enables viewing, editing 
and printing of mainframe and non-ma.inf!lame reports on 
1 a PC. 


Quick Access Archive Viewing System 


Replaces microfiche and provides online access to mainframe reports and 
archived data via indexed data retrieval. 


Console Management System 


Increases system availability and reliability by monitoring all system 
messages, 
responding to 
messages/commands 
automatically, 
etc. 


CONTROb-0 also highlights messages requiring human intervention and 
automates real .. time automation tasks. 
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CONTROL-0/PC 


CONTROL-T 


CONTRO!;,-B 


Remote Console Automation 


Allows remote console automation of an MVS mainframe via a PC, and 
provides consolidation' and' management of messages from multiple 
consoles via a single point of control, 


Removable Media Management 


Optimizes removable media utilization' and provides effective library 
controh CONTRO!J-T controls retention periods, prevents misuse of 


media, and provides improved vaulting controL 


Information Integrity System, 


Performs in~stream validation, and accuracy/reasonability checks on 
information' used by data center pl"oduction tasks (e.g., reports, files, 
databases). 


Related to the IOA family 0:£ products is the Enterprise Controlstation family of pI"oducts 


which enables automation' of MVS and non-MVS platforms. 


A number of common components are shared by IOA products. Furthermore, various IOA 


products use many similar operating p11ocedu11es. 


This remainder of this section1 contains a bl"ief description of components and features 


common to IOA products, followed 1 by references indicating where mol"e detailed 
information can1 be found. 


Installation and Maintenance 


IOA installation is performed using an ISPF menu-driven interface (Installation and 
Customization Engine). 


Maintenance is perfo11med periodically using SMP/E .. 


Installation and Customization Engine (ICE) 


ICE is ani ISPF application used to install and customize IOA products. It consists of a 
series of dialog boxes that provide a simple method for entering data, creating and 
submitting installation jobs. 


Tasks in ICE are organized in a hierarchical: manne11. 


• ICE displays the IOA installation online activities in 
1 the IOA Installation Main, menu, Each 
menu option, rep11esents a key activity related to installing and maintaining IOA (e.g., 


INSTALL IOA, INSTALL CTx, SECURITY, and CUSTOMIZE). 


• Each activity is 011ganized as a high level list of majol" steps. Each majol" step consists of a 
one 011 mo11e minor steps. 


• Each minor step allows the user to perform' tasks such' as parameter specification1 
submissioniofjobs, 011 other tasks related to the installation1process. 


The ICE application1 is described in detail in the IOA InstaUationi Guide. 
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Product Maintenance 


Product Maintenance is the p11ocess by which updates are implemented in the p11oducts 


between releases. Jn, IOA Release 5~0.0 these updates are implemented via SMP/E only. 
Product Maintenance consists of - Periodic Maintenance and Ad hoc Maintenance:. 


• Periodic Maintenance contains improvements to the software and solutions to problems that 
were discove11ed during day-to-day p11oduct use. As the name suggests, this kind of 
maintenance is distributed periodically to the users. · 


• Ad hoc Maintenance contains one or more fixes to a specific pvoblem. It is distributed to the 
user as the need arises. 
See Section 8 fo11 a detailed description: of maintenance implementation .. 


Online Facility 


The IOA Online facility is a set of interactive applications which provides users with the 
basic means of communication with IOA, thus, simplifying implementation· of IOA 


operations .. The IOA Online facility generates all IOA screens and handles all IOA online 
functions. 


The IOA Online facility can be accessed directly under TSO, ISPF, TSO/ISPF and 


ROSCOE. In addition~ the IOA Online facility (IOAOMON) can be accessed via CICS, IMS, 
IDMS, VTAM, ROSCOE, TSO, COM-Pl'...ETE 011 VM under the IOA Online monitov. 


Upon entering the IOA Online environment (the IOA Online facility accessed under a 
communication monitor 011 TSO/ISPF), the user is pvesented with a menu listing available 
options (called the Primary Option1menu). 


The IOA Online facility is described· later in this section. and in Section 2 of this guide. 


Primary Option Menu 


The Primary Option• menu displays IOA product options and facilities available to the user. 


The Primacy Option menu is dynamically generated according to the products and/or options 
available to the user. The IOA administrator can optionally customize the environment so that 
specific products and/or options are available only to certain1users ov user gvoups. 


The IOA Primary Option menu is displayed in one of two possible fo:vmats, depending on 
the number of options available to the user. 


Line Format 


Box Format 


Options we listed one per line with a description, of each option. 


Options are gvouped according to product. No option description is 
displayed. 


Reducing or increasing the number of available options may change the fo11mat in which 
the Primary Option: menu is displayed. 


Menu format and customization a11e described in detail in "Customizing the IOA Primary 
Option Menu~' in 1 Section 2 of this guide. 
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Logic 


Listed below are the different components 0£ lOA p11oducts. 


Automated Processing Definitions 


Automated p11ocessing definitions are the means by which the user communicates to the 


IOA products what tasks to perfol'lm and when, to performi them, Automated pI1ocessing 


definitions contain action statements that describe actions to be perfol'med and criteria 
which define when' and/ol'I under what conditions the defined actions should be performed. 
Each IOA p11oduct contains a definition, facility in which automated pI1ocessing is defined. 


Automated processing definitions are referred to as jobs, rules, or missions - depending on 
the IOA product and the type 0£ action indicated in the definition. 


Job/rule/mission definitions are stored in tables (mem~ers) in partitioned datasets. 
Definitions are activated by scheduling (ordering) themi to an active environment (file 011 
memocy, depending on the pl'oduct). Only then: can, the piioduct process these definitions. 


Automated piiocessing definitions are described in detail in Section 2 of: each IOA piioduct 


usermanuaL 


The different types 0£ automated processing definitions are described in the following 
paragraphs. 


Jobs 


Job scheduling definitions al'le used by CONTROb-M to handle job pvocessing. They can be 
defined. for jobs, started tasks, etc .. Each job scheduling definition indicates scheduling 
criteria and/ov conditions to be met befo11e CONTROb-M schedules or submits a particular 


job. Each definition, also indicates actions to be performed by CONTROL-M after the job 
terminates. CONTROL-M can1 perfovm different post-processing actions, depending on: the 
execution results. 


CONTROL-R parameters and, statements are also defined in CONTROL-M job scheduling 
definitions. 


Missions 


Missions are used by CONTROL-D/CONTROL-V, to determine actions to be perfol'lmed on 
job output. When a mission's scheduling criteria are met, the actions indicated by the 
statements in' the mission' definition are performed~ 


Missions are used by CONTROL-B to define scheduling criteria to be applied to 


CONTROL-B rules which indicate actions to be perfol'lmed. 


Rules 


Rules are used by CONTROL-0, CONTROL-T, the CONTROL-M Event Manager (CMEM), 
and CONTROL-B to respond to specified events (e.g., the detection 0£ a message by 


CONTROL-0). 
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The occurrence of the specified event trigge11s the rule which1 results in the perfo11mance ofi 


the actions specified in the rule. 


Scheduled rules remain active in memory after the perfo11mance ofi the rule. They can, be 


triggered 
1 each time an, occurrence of the specified event is detected. There is no. limit to 
the number of times a rule can be triggered. 


Note 
CONTROL-B rule definitions contain only action statements; CONTROL-B rules are 
either executed upon request without regard to scheduling criteria, or according to 
scheduling criteria specified in a CONTROL-B mission described above. 


Monitors 


IOA monito11s are started tasks which perfo11m: IOA tasks .. There ar:e two types ofi monitors, 


IOA monitors and pr:oduct monitor:s. 


Instructions for: how to· activate and 1 deactivate each monitor are pr:ovided in' the sections 


fo11 the relevant products .. 


A brief description ofi each monitor and its functions follows. 


IOA Monitors 


IOA monito11s perform tasks which may be initiated from any of the CONTROL products. 


IOA Online Monitor (IOAOMON) 


The IOA Online monitor interacts with different environments (e.g., CICS) to p11ovide an 
online interface fo11 the different IOA applications. The online monitor: generates the IOA 


product screens which: are available to users signed on to the online monitor:, and handles 


all IOA Online functions. 


The IOA Online monito11 usually operates 24 hours a day as a started task. The lOA Online 
monito11 is usually activated automatically as part of the IPL process. 


See "The IOA Online Environment" in Section 2 ofi this guide for more infor:mation, 


IOA VTAM Monitor (IOA VMON) 


The VTAM monitor (IOA VMON) enables access to the IOA Online monito11 for VTAM users 
without passing though any TP monito11s (e.g~, CICS,.IMS/DC). 


IOA Functional Monitor (IOAFMON) 


CONTROL-T uses the IOA Functional monitor to pr:ocess certain action' statements (e.g., 


DO CONDITION, and DO SHOUT). 


When an' event occurs (e;g., volume checked in1 dataset created) which requires execution1 
ofi an action, statement via the Functional monito11, the CONTROL-T component writes a 
trace record that describes the needed action~ The IOA Functional monitor reads the 


CONTROL-T Trace file and p11ocesses the specified statements. 
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The Functional monitor is described, in detail in, the CONTROL-T User Manual and the 


IOA Installation, Guide. 


IOA Archive Server Monitor (IOASMON) 


The Archive server pI'ovides access to all repo!'ts migrated to non.-DASD media; thus 
enabling CONTROL-V users to view and print reports. 


Product-Specific Monitors 


Specific p:rioduct monito!'s are responsible for many of the automated operations performed 
by each, p:rioduct. 


CONTROL-M 


The CONTROL-M monitor scans its active environment (file) and, other files and 
determines when jobs should be submitted. It submits jobs, tracks their execution and 


analyzes the results. 


If CONTROL-0 is not installed, and the CONTROI:.-M CMEM facility is active, a CMEM 
monito:ri is activated which processes CMEM rules that were triggered by events in, the system~ 


CONTROL-0 


The CONTROL-0 monitor pI'ocesses rules that were triggered by events in the system and 
records statistics on rule activation and message detection~ 


If CONTROL-Mis installed, the CONTROL-0 monito:ri also assumes responsibility for 
processing of CMEM rules. 


CONTROL-DN 


CONTROL-D activates two monito:ris, the main monitor (the CONTROL-D monito11) and 
the Printers Control' monitor. The CONTROL-D monito11 scans its active environment (file) 
and othe:ri files, and determines when: missions should be pI'ocessed. It p11ocesses missions, 
tracks mission execution and analyzes the results. 


If CONTROL-V is installed, the monitor also handles indexing of reports and their 
migration, to other sto11age media (e.g., Optical' Storage, cartridges). 


The CONTROL-D Printers Control monito11 creates subtasks for each print mission, thus 
enabling pa11allel running of p11int missions. 


Daily Processing/New Day Processing 


For most IOA products, there are a number of tasks that should be peI'fo11med each day. 
Typical daily tasks are: 


• Updating the active enviI'onment (file or memory) with definitions for the new day. 


• Checking files for integrity and validity. 


• Producing general reports that describe the actions taken during the pI'evious day. 


• 
Housekeeping~ Cleaning unneededinformation1from product andIOA files. 
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The above tasks are performed automatically via the New Day p11ocedure for each product. 
The New Day procedure is a program used to automate daily maintenance tasks and 
automatically schedule processing definitions for each day. 


New Day procedures and User Dailies are described' in the beginning 0£ the sections for 
the relevant p11oducts in this guide (e.g., Section 3 for CONTROL-M.). 


File Management 


There are two major ways to 1differentiate between, files which are used by IOA products. 


• According to·their access method 


Files managed using a common, internal access process called the IOA Access Method~ 


- 
Files managed using standwd access methods. 


• Acco11ding to their usage 


IOA Co:ve files which we sha:ved among IOA products. 


- 
Product repository files which we exclusively used.' by a particular IOA product. 


IOA Access Method 


Certain IOA p11oducts have files that are managed using an internal file access process 
called, the IOA Access Method. 


IOA Access Method files are sequential datasets in an indexed (keyed) file structure that offers 
enhanced data integrity. IOA Access Method files are managed (e.g., allocated~ foI1matted and 
accessed) via a special set ofIOA utilities (described in Section 9ofthls guide). 


Most IOA Access Method files consist of two separate sequential datasets: 


• A data component, where the actual: information resides. 


• An index component, whlch1provides keyed access to reco11ds in the data component. 


Certain IOA Access Method files contain only an index or data component. 


Both index and data information are stored in· compressed, fo:vmat, resulting in' reduced 1/0 


p11ocessing overhead and improved disk space utilization. 


The IOA Access Method is described in greater detail in Section 2 of this guide. 


IOACore 


The IOA Co11e is a collection of files which are shared by all IOA p11oducts at your site .. The 
following IOA files comprise the IOA Co11e: 


Log File 


Contains messages generated by IOA products. Messages can be viewed via option 5 in the 


IOA Primary Option menu. The IOA Log file is cyclic and stores a limited number of 
messages (specified via an installation parameter). Each new entry in the IOA Log file 
overwrites the oldest existing entry if required. 


The IOA Log file is described in detail in Section 2 0£ each product-specific user manual. 
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Conditions/Resources File 


The IOA Conditions/Resources file contains infollmation1 on the status and availability of: 


resources system wide. IOA conditions and resources can be viewed via option 4 in the IOA 


Primary Option menui. The following types 0£ information, are included in this file: 


Prerequisite conditions 


Quantitative resources 


Control: resources 


User-defined conditions set as "in conditions" (via IN statements) or 
"out conditions" (via. OUT and/oil DO COND statements) in 
job/rule/mission; definitions. 


• When a condition is defined as an, "out condition\" it is set (in the 


IOA Conditions/Resources file) 
during 
Oil 
following 
the 
processing of the job/rule/mission, 


• When, a condition1 is specified as an' "in condition," the· condition 
must exist in the IOA Conditions/Resources file befolle the 
job/rule/mission can be processed. 


• Prerequisite conditions can be used in this way to· make the 
execution1 of: one job/rule/mission dependent on the execution of 
another. For example, a job with a particular "in condition" 
cannot be submitted until ajob with the same condition' specified 
as an; "out condition:" was executed and set the condition, 


Prerequisite conditions can also be used to· indicate that a required 
manual operation has been perfollmed. 


Quantity of a resoullce in1 the system, Different jobs may require 
different quantities ofi specific resources (e;g;, ajob may require two 
tape drives). 


Specification: of Quantitative resource requirements for a job 
provides a solution foll the allocation of: quantitative computer 
resources (e;g,, cartridge drives, CPU utilization, database access 
rate). Specification, of: Quantitative resource requirements increases 
computer throughput by controlling access to· these resources, thus 
preventing execution: bottlenecks. 


Usage (Shared/Exclusive) of a specific resource .. Some jobs may 
require a resource to be in' a specific mode (e.g,, a backup job may 
require exclusive access to a specific dataset). 


Specification of Control1 resource requi11ements foll a job/mission 
provides a solution' for the pnoblemi of resource sharing between 
different jobs .. The Exclusive or Shared mode in: which a Control 
resource is requi11ed by a job is also specified; 


IOA considers the mode of resoU11ce usage required when 
1 allbcating 


Control1 resou11ces and prevents jobs whose resource usage is 
incompatible from executing simultaneously. 


See Sections 1 and 2 in, the appropniate user manual fo11 mo11e infonmation regarding the 
use of the IOA Conditions/Resou!lces file. 
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Manual Conditions File 


File that contains pverequisite conditions that must be added manually (e.g., they are required 
by jobs in the active environment but we not automatically added by other jobs in the active 
environment). 


Calendar Tables 


Calendars determine on1 which days automated process definitions (jobs/rules/missions) 
should be p11ocessed .. Calendars can be used to simplify the definition of scheduling criteria~ 


IOA calendars are organized on a yearly basis, each calendar listing all the days in a 
specified year, with an indication stating if an automated definition1 should be processed that 
day. 


Each calendar is assigned a unique name, which can be specified via Basic Scheduling 
parameters of an automated processing definition (subparameters DCAL, WCAL, and/ol' 


parameter CONFCAL). 


Calendars can be defined, as either regular or periodic: 


• Regular calendars contain schedules that can1 be easily defined using Basic Scheduling 


pwameters .. These calendars consist of scheduling dates or days (of the week) which can be 
fixed according to ·monthly patterns. 


Regular calendars are especially useful, when a large number of jobs have the same 
schedule; By defining the schedule once in a calendax:, and specifying the calendar name in 
the automated processing definitions with that schedule, it is unnecessary to. individually 
define that schedule in each definition, 


• Periodic calendars we especially useful when basic scheduling criteria would be difficult to 
define because they do· not easily conform to fixed date/day of the week/month breakdowns. 
For example, you may need to schedule a pamcular job. every fourteen days regwdless of 
date. 


The IOA Calendar facility is described in Section 2 ofi each pvoduct-specific user manual:. 


Product Repositories 


Each IOA product uses a variety of different files to accumulate information about its 
operations. These files are referred to collectively as the product repositories (regardless ofi 
their access method). A list of some of the move important files in, each IOA pvoduct's 
repositol"y and a b11ief description of the contents of each file. Mo11e information about each 
product's repositovy can be found in, Section1 1 of each product-specific user manual. 


Note 
In addition to the following list, libraries and tables which contain automated process 
definitions for each JOA product are also part of each JOA product repository. 


CONTROL-M 


Active Jobs file 
The CONTROL-M active environment contains copies of the 
ordered job scheduling definitions and the status of those jobs. 
Accessible via option 3 in the IOA Primary Option menu. 
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Job.Statistics file 


Job Network file 


CONTROL-DN 


Active Missions file 


User Report List files 


Active Transfer file 


CONTROL-0 


Message Statistics file 


Automation log 


Job execution statistics (e.g., elapsed time for each job). Updated 


via utility CTMJSA. Accessible via option S in the Status screen 
(which is accessed via option1 3 in the IOA Primacy Option menu). 


Dependency information, about jobs in, the Active Jobs file .. 


Accessible via option1 Nin the Status screen (which is accessed via 
option 3 in the IOA Primary Option menu). 


The CONTROL-DIV active envi11onment contains copies of pending, 
executing and recently executed missions, and mission status. 
Accessible via option A in: the IOA Primary Option' menu. Managed 
by the IOA Access Method~ 


Information1 about repol1ts sent to a specific user. Repol1ts can be 
selected fo11 Online Viewing, deleted, and transferred· to other users. 
Accessible via option U in, the IOA Primary Option menu. These 


files are managed via the IOA Access Method utilities. 


The following types of user reporl list files exist: 


Permanent 


Active 


Migrated 


Histoey 


A list of all reports defined to CONTROI:..-D. 


Recently (and/or soon to be) processed reports. 


Reports migrated from DASD to· vacious sto11age 


devices (CONTROL-V only). 


Reports backed up on1 tape or cartridge. 


Info11mation about packets that are scheduled fo11 transfer to· a PC. 
Only relevant for sites with CONTROL..-D/PC. Accessible via 
option' Fin the IOA Primary Option' menu. 


List 0£ all messages and commands detected in the system, and 


vacious information1 about each message (e.g., frequency, and 
whether 011 not they were suppressed). Accessible via option OM in 
the IOA Primary Option menu~ 


Automation 1information1about allinput available to·CONTROL-0:· 


• Console, IMS, and CICS messages and commands. 


• CONTROL-0 internal1 messages. 


• CONTROL-0 rule traces. 


The Automation log can be accessed via option 1 OL in, the IOA 
Primary Option menu• 


Global Variables library 
A list of all 
1 user-defined Global variables. The members of this 


lib11ary we loaded· when CONTROL-0 is stallted, and 
1 these 
members can1 be updated; defined) or updated via various operato11 


commands. 
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CONTROL-B 


Active Balancing file 
List of all CONTROL-B missions loaded during the CONTROL-B 


New Day p:mcedwe and information about rule status. Accessible 
via option' BB in the IOA Primary Option menu. 


CONTROL-B Report file 
Detailed, information (Balancing report) about each invoked 


CONTROL-Brule. Accessed via option R in the Rule Activity screen 
(BA). 


CONTROL-T 


Media Database 


Trace file 


Stacking Statistics file 


Information.on all 


1datasets and volumes managed by CONTROL-T. 


Reco:rid ofi activities in: the CONTROL-T enl!Wonment. Used 


primarily for recovery ofi the Media Database. 


Statistical information on each dataset which is used by 


CONTRO:L-T to estimate the amount ofi space required fo11 that 
dataset. Information about previous generations 0£ the dataset is 
used to· calculate space requirements for storage of each, dataset. 


Statistical information can be extracted from repository files via various utilities and 
KeyStroke Language (KSL) reports: 


• Utilities are described in: Section: 9 ofithis guide. 


• Information extraction via KSL reports and/or sample KSL reports are described in detail in 
the p11oduct-specific user manuals. 


Miscellaneous 


Dynamic Destination Table 


The IOA Shout facility allows the user to specify messages to be sent to particular 
destinations upon the occurrence of specified events. However, it may be necessary to send 
a particular message to several destinations, and/or a particular physical destination may 


va11y depending on time of day or other factor (e.g., the TSO logon1 ID of the shift manager 
may be different for each shift). 


These situations are handled by defining groups of destinations in a Dynamic Destination: 
table. The Dynamic Destination table consists of a site-defined list 0£ Iogical destination 
names. For each logical (i.e., group) destination, name, a list of physical destinations is 


defined·. 


A logical destination' name can be specified for a Shout message. The message, when 
shouted) is sent to each physical destination defined to the logical location. If the physical, 
location, is logged on, it will receive the message. 


Multiple Dynamic Destination tables can be defined, one ofi which is defined as the default. 
This Dynamic Destination' Table is loaded when the product-specific monitor (e.g., the 


CONTROL-M monitor) is started. A different Dynamic Destination table can be loaded via 
operator command. (Shout messages are directed by the p11oduct-specific monitor to the 
Dynamic Destination table in memovy .) 
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When a change is made to the Dynamic Destination Table in memory, and it is desired 


that the change be implemented immediately, the table should be reloaded into each 
product's memo11y. 


(Fo11 information, regarding the loading and reloading ofi Dynamic Destination tables in' 
memo11y, see "IOA Dynamic Destination Table" in, Section 2 of this guide.) 


AutoEdit Facility 


The AutoEdit facility allows symbolic representation1 (via AutoEdit variables) 0:£ dynamic values 


(e.g~, values which change from execution' to execution, 011 from day to day) .. Each variable is 
resolved at the appropriate time, and the resolved value is substituted for the variable. Special 


AutoEdit functions and control' statements enable manipulation of values specified fo11 these 
variables. The variables can, be used in job/rule/mission definitions in, various ways allowing 
flexibility and high level logic in automation of youl' work environment. 


In addition, AutoEdit variables and functions can' be used in1 different ways for each IOA 
p11oduct. The AutoEdit facility can be especially useful in, the following: 


• JCL setup of jobs submitted unde11 CONTROL-M. 


• Messages issued withtheIOA Shout facility. 


• Report scripts written1in the KeyStroke Language (KSL). 


• KeyStroke OpenAccess scripts used by CONTROL-0 to interact withVTAM applications. 


See relevant user manuals for how the AutoEdit facility can be used with the prioducts at 
your site. 


Security Implementation 


IOA p11oducts can be pl'otectedjust like any other data center application. IOA has built-in 
interfaces to 
widely used security 
environments (e.g., 
RACF, 
CA-ACF2 
and 


CA-TOP SECRET). Eachi IOA function is associated with a security module. These security 
modules ave used to· check user autho11ization fov requested actions, and to permit 011 deny 
the actions accovdingly. Jn, addition, user exits are invoked befo11e the security modules to 
allow the user to· perform required user functions that are not related to· security. 


IOA security is described in detail in the IOA Security Guide. 


User Exits 


IOA user exits can be used to influence the continued ope11ation, of an, IOA product at 
specific points in1 processing. 


For example, an exit can, be used to, check user authorization fo11 a specific action or to 
modify report banners and indexing befo11e p11inting. 


Exits are described in Section, 10 ofi this guide. Detailed, information about each exit is 
provided in the IOA SECUDATA libl'a11y. 
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Utilities 


Utilities are specialized programs designed to perform specific tasks in the IOA product 


envii:ionment. Some utilities are provided with all IOA products, and some are p11oduct specific. 


A comp11ehensive list of all lOA product utilities is provided in the beginning of Section 9. 
Unless otherwise indicated, these utilities are describedin detail:in,the remainder of Section 9. 


Utilities of special inte11est to p11oduct users are described in the user manual fol' the 
relevant p11oduct. 


Simulation 


Prior to IlUlllling a complex task for the first time, or during a conversion from another p11oduct, 


it is often useful to be able to first perform the task (or conversion~ in simulation mode. For this 


reason; certain IOA products and utilities can be run: in simulation: (TEST) mode. 


In simulation mode, the IOA product has no effect on, your system. However, certain 
products (or utilities) can generate files containing information1 which is useful for 
checking performance .. 


Cross-Product Communication 


Certain IOA products can perform1 actions in a response to information received from another 


IOA product. 


A description of some ways in which IOA products can interact follows: 


File Access 


The IOA Core files are accessed by more than 1 one product. A change can be made in one of 


these files by one product, and the file (and the change) can, then be read: by another IOA 


product. 


Example 


A prerequisite condition set by CONTROL-0 is detected by CONTROL-M during its next 
scan of the IOA Conditions/Resources file. As a result of the detected, condition, 


CONTROL-M can then run a job whose execution: is dependent on this condition (i.e., the 
condition is specified: in the job~s IN parameter). 


See the description of the IOA Core earlier in this section for more info11mation on files 
shared by IOA products. 


Automated Processing Definition Statements 


Some statements in automated processing definitions (e.g., job scheduling definitions) can 
1 


be used by one IOA product to directly influence the operation of another IOA product. 
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Examples 


The DO FORCEJOB statement can be used by other IOA pl'oducts to instruct 


CONTROL-M to fo11ce (unconditionally schedule) a specifiedjob. 


Parameter CTB STEP specified in a job scheduling definition' can be used to trigger a 


CONTROL-B rule. 


Special Cross-Product Interfaces 


Some IOA products have special interfaces to other IOA products installed, at the same 
site. Special interfaces that exist for specific combinations of IOA pvoducts ave discussed in, 
the relevant p11oduct-specific sections of this guide. 


Example 


CONTROL-R has a special' Drive11 exit which it uses to interlace with CONTROL-T. 
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Introduction 


This section describes the customization facilities available within IOA. The following 
topics are described: 


• The lOA Online Environment 


• Customizing the Online Environment 


• The IOA Access Method 


• IOA Profiles 


• Modifying IOA Product Defaults 


• Modifying IOA Messages 


• The IOA Dynamic Destination Table 


• Expanding the IOA Resource File (RES) 


• Expanding the IOA Log File (LOG) 


A detailed! description 0£ each topic follows. 


The IOA Online Environment 


The Online facility can be activated under the following environments: 


TSO (native) 


TSO/ISPF 


ROSCOE/ETSO 


CICS 


VTAM 


1MS/D8 


ID MS/DC 


CA-COM-PLETE 


Options for Cross-Memory interfaces to the Online monitor address space are available 
under native TSO and ROSCOE/ETSO. 


There are slight differences in the operation of the Online facility under different 
environments. 


The following paragraphs describe how the IOA Online monitor facility pnovides suppont 
fon various environments using CICS as a model scenario. The description also applies to 
the following environments: 


IMS/DC: 


VTAM 


COM-PLETE 


ID MS/DC 


ROSCOE Cross-Memory Interface 


TSO Cross-Memory Interface 
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Entering the IOA Online Facility 


In TSO and ISPF, the IOA Online facility is entered by running a CLIST (located in the 


IOA CLIST library). The CLIST calls IOAONL, which is the main CLIST that activates the 
Online facility in the specified environment. 


The following CLISTs al'e provided with IOA: 


IOATSO 


IOAlSPF 


IOAXTSO 


For activating IOA Online in a TSO environment. 


For activating IOA Online in an ISPF environment. 


For activating IOA Online under TSO through Cross-Memory services. 


The fovmat fov the CLIST used to activate the IOA Online environment under ISPF or 


TSO is as folfows: 


:COAONL APPL'l'YPE(atype) 
['l'RAN:CD(transmem).] 


Where: 


a type 
Type 0£ environment under which IOA is run . .Valid values are: 


I 
s 
x 


ISPF. 


TSO. 


Online monitor. 


transmem 
Name of the relevant transaction member in the IOA PARM library. The 
name of this member must be no more than, four characters long. 
Optional. 


If no transaction member is specified a full list of all options for the 
installed products is displayed. 


For mol'e information' see "Transaction Members" later in this section. 


Example 


At a site where CONTROL-Mand CONTROL-D are installed, the following CLIST enables 
all options for CONTROL-Mand CONTROL-D under TSO: 


%:COAONL 
APPL'l'YPE(S) 


Note 
Dataset allocation for the JOA Online environment can be customized via 
specification of overriding or alternative allocation members in the CLIST used to 
activate the JOA Online environment. For more information, see "Allocation 
Members" later in this section. 


It is possible to pass a transaction ID di!lectly as a positional parameter to either the 


IOATSO or IOAISPF CLISTs. For example: 


:COA'l'SO DMAN 


will activate the IOA environment under TSO, setting up only the IOA and CONTROL-D 


options regardless of other products installed at the site (where transaction member 
DMAN contains the appvopriate statements). 
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Example 


The following CLIST and transaction member combination enables only option U of 


CONTROL-D under ISPF (where transaction member D0LV contains the appropriate 
statements). 


In the CLIST library: 


%:tOAONL·APPL'rYPE(:t) 
'rRAN:tD(DOLV) 


See the explanation of transaction members later in this section for more information. 


IOA Online Monitor 


The IOA Online monitor interacts with different environments (e.g., CICS) to provide an 
online interface for the different IOA applications .. The online monitor generates the IOA 


product screens which are available to users signed· on to the online monitor, and handles 


all IOA online functions. 


Each IOA Online monitor usually operates 24 hours a day as a started task. The IOA 
Online monitor is usually activated automatically as part of the IPL process. 


Principles of Operation 


To enable the same user interface to be activated by users under different environments, a 
virtual environment is built for each user, which handles all actions a user requests to 


perform in the IOA environment. Thus, any environment being used at a site can be 
supported by adding a customized routine to convert the virtual environment to the site's 
environment. 


CICS 


User 


Transaction 


Terminal 
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A special started task, named the IOA Online monitor, provides an environment for 
executing IOA applications. One or more online monitors can be started, and, each monitor 
can support several virtual environments (signed-on users). 


Each monitor can customize IOA product screens, constants, messages, colors, commands 
and PFKey definitions to adapt them to the site's requirements. It is recommended that 
the same prefix be used for each group of monitors which are customized for specific 
functions. See the explanation on parameter IOAXPARM in the IOA Installation Guide for 
more information, 


In addition to site-wide Global profile customizationi each IOA product can be customized 
to respond differently to individual users signed on to the online monitor through 
variables specified in User profiles. 


In the CICS environment, a small conversational transaction, communicates with the IOA 


Online monitor using cross-memory services. The CICS transaction receives a screen from 
the user terminal, and passes the screen, to the IOA Online monitor for processing. The 


IOA Online monitor returns a screen' (to be displayed) to the CICS transaction which in 
turn sends this screen to the CICS user at the terminal. Using this method, the IOA 


application is performed outside CICS, and the normal 
1 CICS function is uninterrupted. 
The memory requirement of each user in the CICS region is approximately the size of the 
screen (i.e., 2x24x80=3840 bytes). 


The IOA Online monitor activates each user as a subtask. Therefore, in, the event of an error or 
abend of a user application, other users working under the Online monitor are not affected. 


IOA applications work above and below the 16MB line. Therefore, region size limits may 
restrict the number of users who will be able to work concurrently under the same Online 
monitor. To solve this potential problem, it is possible to open any number of additional 


IOA Online monitors. When the user enters the IOA CICS transaction code, the IOA CICS 


application searches for a free space in one of the IOA Online monitors which is currently 
active. The process of choosing the correct monitor is transparent to the CICS user. Using 


this method) there is no limitation on the number of users signing on to IOA. 


It is possible to balance the workload of two or more IOA Online monitors .. Refer to 
parameter BALANCE in the "Install IOA Online Monitor" step of the IOA installation 
procedure. 


The actual number of users under one monitor varies according to their memory requirements 
(influenced by how many screens they use concurrently, what type of IOA options they are 
using, etc.). Many options exist in the IOA Primary Option menu. However, there is no 
reason for every user to access all options of each product. It may be desirable to limit 
access to certain' options to only a selected group of users .. This is done by passing a 
transaction code to the Online monitor. See "IOA Online Monitor" later in this section for 
more information, It is also possible to determine that certain monitors allow users to sign 
on only with specific transactions thus enabling monitors to be specialized for different 
groups and numbers of users. 


Note 
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The CONTROL-D Online Viewing facility runs mostly above the 16MB line. 
Therefore, it is possible to activate a maximum of approximately 70 Online Viewing 
users under one monitor. However, these users should be limited to Online Viewing 
transactions only. This can be done byforcing users to sign on with the transaction 


IDDOLV. 


IOA Rel. 5.0;0 Administrator Guide 


u 


u 


u 


Section 2: Customizing and Administering IOA 


A data center can run more than' one CICS in the same computer. From the IOA point of 
view, this is transparent to the user. The IOA Online monitor always returns the screen to 
the CICS which issued the request. It is possible to define additional transaction, IDs for local 
use (e.g., 
a transaction ID offering all options of the menu except for the 
Conditions/Resources screen). See "Customizing the IOA Online Environment" in this section 
for more information, 


Activating the IOA Online Monitor (IOAOMON) 


Each IOA Online monitor usually operates 24 hours a day as a started task. Usually the 


IOA Online monitor is automatically activated as part of the IPL pvocess by the operator 
command. For example: 


Smonitor_name 


The names of the online monitovs available in a site are defined in member IOAXPARMin 


the IOA PARM library (described. later in this section~. 


If the IOA Online monito11 is successfolly activated, the following message is displayed on 
the operator console: 


CTM777:C monitor-name ONL:CNE MON:CTOR :CN:CT:CAL:CZAT:CON STARTED 


After a few seconds the following message is displayed: 


CTM778:C monitor-name ONL:CNE MON:CTOR :CN:CT:CAL:CZAT:CON COMPLETED 
If you try to activate more than one monitor with the same monitor ID in the same computer, 
the newly-activatedmonitor immediately shuts downandarelevant message is issued. 


Note 
The JOA Online monitor uses cross-memory services to communicate with other 
address spaces requesting services. Like other address spaces using cross-memory 
services, whenever the JOA Online monitor is shut down, the address space entry 
in the MVS Address Space Vector Table (ASVT) remains non-reusable until the 
next IPL, and the message IEF3521 is issued (in some MVS releases). If the JOA 
Online monitor is brought up and down many times, the ASVT may become full. 


New address spaces will not start, and an immediate IPL may be required~ 


To prevent this problem,. specify a large enough value in MVS initialization 
parameters MAXUSER,. RSVSTRT and RSVNONR in member IEASYSXX in the 


SYSl.PARMLlB library. 


Information about these parameters can be found in the "MVS Initialization and 
Tuning Reference" manual. 


Displaying a List of All Active Users 


Specify the following operator command: 


F monitor_name,D:CSPLAY 


The following list appears on the operator console from which the modify command was issued: 


CTM645:C 
MON:CTOR USER PGM TRAN:CD TERM:CNAL START LASTUSED ST 


CTM646:C 
monitor user pgm tranid terminal start last 
status 
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Message CTM646I contains the following data for each user in the IOA Online monitor: 


MONITOR 


USER 


Name of the IOA Online monitor 


User ID 


PGM 


TRANID 


TERMINAL 


START 


LASTUSED 


Name of the program which is active 


Transaction ID. (See the IOA Installation Guide for an explanation.) 


Terminal ID under the IOA Online monitor 


Start time (hour and minute the user entered the Online facility) 


The last time the user performed an action with the Online facility 
(hour .minute .second) 


ST 
Status: 


W 
Waiting for input (from the terminal) 


A 
Active - working 


Deactivating the IOA Online Monitor 


To deactivate the IOA Online monitor, use operator commandc 


P monitor_name 


Problem Determination 


A problem may be encountered' when the Online monitor is active but users cannot access 
the monitor, and error message CTMOllE is displayed by program CTMCINT. The reason 
may be that IOA has either determined that no Online monitor is active, or that IOA 


cannot access the monitor which is active due to one o:t:the following reasons: 


• The name of the Online monitor is not found in the list of active Online monitors .. This 
may occuii if: 


- 
Exit 9 is not passing a correct name .. Exit 9 can determine the name of the Online 


monitor to be accessed. It is possible that the exit was not customized as required, 
and the wrong version of exit 9 is being used, or that faulty versions of member 


IOAPARM and/oii IOAXPARM exist in the IOA LOAD library. 


- 
There is no active Online monitov. There may be other Online monitovs active, but 
they are not the correct ones. 


- 
Whenever the user attempts to connect under TSO Cross-Memory, both the Online 


monitor, and the TSO user must be running on the same CPU. Otherwise TSO 
Cross-Memory services cannot recognize that there is an Active Online monitor 
running on a different CPl'.J. 


• The subsystem does not match the subsystem name specified in member IOAXPARM. 


This may occur if a different subsystem is active, or a wrong version of member 
IOAXPARM is being used. 
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• A problem is identified in the subsystem chains. The address of the Online monitor 
chain cannot be found. This may occur if: 


- 
Modules from different IOA releases were activated together (e.g., a wrong or bad 
library is concatenated, or the library itsel£ contains faulty programs). 


- 
When signing on from TSO Cross-Memory the Online monitor is not running on the 
same CPl'.J as the one from which an attempt was made to· sign on~ 


The VTAM Monitor (IOAVMON) 


The VTAM monitor (IOA VMON) enables access to the IOA Online monitor for VTAM users 
without passing though any TP monitors (e.g., CICS, IMS/DCJ). 


Activating the VTAM Monitor (IOA VMON) 


The VTAM monitor usually operates 24 hours a day as a started, task. The monitor is 
usually automatically activated as part o~ the IPL process by operator command: 


S J:OAVMON 


The VTAM application: should be active before starting the VTAM monitor. To activate the 


VTAM application manually, use VTAM command: 


v NET,ACT,J:D=ioaappl 


Where ioaappl is the VTAM major node containing the IOAVMON acbname. 


If the VTAM monitor is successfolly activated, the following message appears on the 
operator console: 


CTM7AOJ: 
monitor name VTAM MONJ:TOR J:NJ:TJ:ALJ:ZATJ:ON STARTED 


After a few seconds, the following messages are displayed: 


CTM7A1J: monitor name VTAM MONJ:TOR J:NJ:TJ:ALJ:ZATJ:ON COMPLETED 


CTM7ACJ: monitor name ACCEPTJ:NG LOGONS TO acbname 


Only one VTAM monitor can be activated at a time. 


Deactivating the VTAM Monitor 


To.deactivate the VTAM monitor, use operator command: 


P J:OAVMON 


Displaying a List of All Active Users 


To display the list of users logged onto IOAVMON, enter operator command: 


F J:OAVMON,D· 


The following list appears on: the console from which the modify command was issued: 


CTM7BOJ: monitor - 
TERMJ:NAL TRANSJ:D 


CTM7B1J: monitor - 
LUname transid 
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Customizing the IOA Online Environment 


All IOA products are accessed via the IOA Online environment. This environment can be 
customized to meet your site's needs. Using the methods described below, you can1 for 
example, modify menus and allocation tables, and control users' access to the various 


featu11es of the IOA products installed at your site. 


Transaction Members 


A transaction, member is a member in which each line contains customization, information 
for one of the IOA products installed at the site. Transaction members are line-oriented. 


Transaction members can be used to· determine: 


• Which products are available to the user. 


• Which options of each product are available to the user. 


• What program member is to be used by the transaction. 


The valid format for a line in' a transaction, member is: 


product [optiona, optionb, ••• optionx] [PGM=pgmlist] 


Where: 


product 
IOA product described in the line. Valid values are: IOA, CTM, CTD, 
CTT, CTO, and CTB. 


Products do not need to be listed in any specific order. Only products 
listed, in the transaction member are made available to the user. 


optiona, optionb,.x 
Option codes of options to be displayed; or ALL. The option codes are 
the one or two character codes that are entered in, the command line 
to indicate choice of a specific option. If ALL is specified, all options of 
the product described in the line are displayed. 


pgmlist 
Name of the Program List member to be used for activation of the IOA 


product described: in this line. See "Program List Members" later in 
this section, for more information. 
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Notes 
Transaction 
members 
corresponding 
to 
transactions 
(application IDs) used in releases prior to IOA Release 5.0.0 


are included in the IOA PARM library for your convenience. 


Certain transaction names cannot be used for user-defined 
transaction members. Reserved transaction names are: IOAX, 
DOLV, KOA, VK, IALL,.and ECS. 
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Example 


Member DOLV in the PARM library specifies option U of CONTROL-D: 


CTD 
U 


Member DMAN in the PARM lib11ary specifies all options 0£ IOA and CONTROL-D: 


J:OA ALL 


CTD ALL 


A transaction member that will contain only option 3 of CONTROL-M and options 4 and 5 
of IOA will look like this: 


CTM 3 


J:OA 4,5 
If a transaction member specifies only one option, once activated, the option will be 
accessed directly without displaying a menu panel. If more than one option is specified, 
the following options will automatically be added to the menuc 0,1 and X. Therefo11e, the 
minimum number of options that will appear in a menu member is 5. Options 0,1 and X do 
not need to be specified in transaction members and should not be specified in PGM 


members (described later in this section). 


Program List Members 


A Program list specifies a member containing a list 0£ programs to be activated for the 
options of an IOA product. A Program List member exists for each 0£ the IOA products 
(including IOA). 


The naming convention for Program List members is PGMxxx, where xxx is the product 
suffix (e.g., PGMCTM is the Program List member for CONTROL-M). 


Each product has its own program list member, which contains all the options of the 
product. Unless specified otherwise in a transaction member, the product's program list 
member will be used to specify which options of the product are to be available for users. 
The PGM list member will be used only if the pnoduct is installed as specified in member 


IOAPARM in the IOA PARM library. 


Program List members are line-011iented members where each line describes a program in 
the relevant product. 


The valid format for a line in a Program List member is as follows: 


program DELETE envir [=Joptioncode 


Where: 


program 


envir 


Program described in the line. If the program has been modified, the 
name of the new (modified) program should be specified here. 


One-character designation of the environment(s) in which the 
program option is to be made available. Valid values fo11 envir are: 


I 


R 
s 


ISPF 


KSL 


TSO 
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= 


optioncode 


x 
* 
blank 


Online monitor 


AU environments 


No environments 
If specified, the equal, sign indicates that this option wiU be accessible 


from all screens in, the IOA enviI~onment using the transfer command 
(e.g., =5 transfers the user to the IOA Log screen). If no equal sign is 
specified) the option is only available from the IOA Primaey Option menu. 


A one- or two-character option' code used to· activate the specified 


program,. To specify a different option code for a program, specify the 
new option code here. Mo11e than one option1 code can be specified for 
each program' No two programs may have the same option code. 


Note 
Changing the option code listed in the Program List member affects 


only· the operation of the program. To ensure that the display shows 
the new option code, it is necessary·to.update member MENU in the 


MSG library (described later in this section). 


Option codes for options 0,1, and X are reserved and cannot be 
changed. 


The following default Program List members are located in the IOA PARM library: 


PGMCTB 
PGMCTD 


PGMCTM 
PGMCTT 


PGMCTO 
PGMCTR 


PGMCTV 
PGMIOA 


Sample Program List member for CONTROL-0 (member PGMCTO): 


CTOTOMP DELETE * =OR 
CTOTMSC DELETE * =OM 
CTOTARF DELETE * =OS 
CTOTAOP DELETE * =OA 
CTOTALO DELETE * =OL 


An alternate Program List member can be used to specify a modified version of a specific 


program (or p11ograms) to be activated for a specific option(s). 


Alternate program lists must contain, programs for all available options of the relevant 


p11oduct available to the user. 


Allocation Members 


Allocation of files and· datasets for each, IOA product are specified in Allocation members. 


The naming convention for Allocation members is ALCxxx, where xxx is the name of the 


p11oduct. Each product has its own Allocation' List member which contains all the 
allocations that need to be made to access the product using the online facility. The 
datasets which are specified in a product allocation member list will only be allocated if 
the p11oduct is installed as specified in member IOAPARM in the IOA PARM library. 
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The following allocation members are located in the IOA PARM library: 


ALCIOA 
ALCCTM 


ALCCTD 
ALCCTB 


ALCCTT 
ALCCTO 


ALCCTR 
AL CCTV 


The valid format of an: Allocation member is as follows: 
product/s DD=ddname,DSN=dsname,M=member_name,DJ:SP=disposition 


Where: 


product 


ddname 


dsname 


member_name 


disposition 


* 


Example 


One letter product name specified per product in columns 1-9. If a 
blank is specified, the format applies to all products. 


Should appear between columns 10-80. Mandatory. 


Should appear between columns 10-80: Mandatory. 


Should appear between columns 10-80. Optional. 


Note 
If you do not use member name, you should not specify M= in 
an Allocation member. 


Should appear between columns 10-80~ The default is always SHR, 
unless specified otherwise. 


Note 
If you do not use disposition, you should not specify DISP= in 
an Allocation member. 


In column 1, represents a comment line. 


CTMHELP should be allocated if any CONTROL product is installed: 


DD=CTMHELP,DSN=J:OA.VSOO.MSG 


To-customize allocation at your site, specify one of the following DB statements in the CLIST 


(or the Online monitor procedure or the KSL) used to activate the IOA Online facility: 


DAOVRALC 
Specifies a member containing allocations that override corresponding 
allocations in the Allocation member list for the relevant product. 


The datasets specified in the appropriate products in the allocation 
member are all allocated. However, any allocations 
for~ datasets 
specified in the overriding member are also allocated and they will 
override the co11responding allocations. 


CLIST with an overriding Allocation member: 


PROC 0 
APPLTYPE(S) 


TRA?UD (TRANSACTJ:ON_J:D_MEMBER) 
ALLOC DD(DAOVRALC) - 


DSN( 'J:OA.VSOO.PARM(,ALCOVR)') SHR REU 
%J:OAONL-APPLTYPE(&:APPLTYPE) TRANJ:D(&:TRANJ:D) 


FREE DD(DAOVRALC) 


END:END 
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DAALTALC 
Specifies a member containing allocations to replace the allocations in 
the Allocation membe11s for all products at the site .. 


The alternate list must contain' all: necessary allocations to the 
environment as none of the default Allocation' members will be used. 


Cll.IST with an alternate Allocation member: 


PROC 0 
APPL'il'YPE(S) 


TRAN:ID (TRANSACT:ION_:ID.:...MEMBER) 


ALLOC DD(DAAL'il'ALC) - 


DSN( I :IOA. vsoo .PARM(ALCAL'il') I) SHR REU1 


%:IOAONLAPPil'il'YPE(&:APPL'il'YPE) TRAN:ID(&:TRAN:ID) 


FREE DD(DAAL'il'ALC) 


END:END· 


If neither an 
1 overriding Allocation member nor an1 alternate Allocation, member is 
specified, the default Allocation members are used. Overriding and alternate Allocation 
members can be stored in the IOA PARM library. 


Only one overriding or alternate Allocation member can be specified in a procedure (e.g., a 


CLIST) .. However, multiple overriding and alternate Allocation members can be created at 
a site fo11 use with different CLISTs and Online monitor p11ocedures. 


Sample ALC Member (ALCCTO) 


DD=DAPASCTO,DSN=%:ILPREFA%.PARM,M=PASCTO 


DD=DALOAD,DSN=%STEPL:IB%%LANG% 


Note 
If a concatenated allocation is required, delete the original allocation from the 
appropriate ALCxxx member and add it to the user's procedure, CLIST, JCL, etc. 


Modifying IOA Online Facility Commands 


Every screen ofi the IOA Online facility supports a set of commands. It is possible to 
change the names of these commands or to create synonyms. The commands reside in the 


IOA PARM library in members with the following naming conventions: 


TxxxCMDl 
Active commands member. 


Where: 


xxx is the screen identifier. Appendix E contains a detailed list of all options, screens and 
their corresponding command members. 


A command· member is composed 
1 ofi one header line and any number ofi command lines. 
The number at the left of the header line is the total number of command lines in, the 
member. It must be updated when lines are added to 011 deleted from the command 
member. 
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The structure of the command line is: 


Columns 
Description 


Command name. 


Reserved hexadecimal (unprintable) value. Do·not modify. 


Description of the command. 


1- 8 


25-28 


29-68 


69-72 
Reserved hexadecimal1 (unprintable) value representing the internal 
command number. Do·not modify. 


It is possible to change the command name and/or the description by typing in the change. 
To add a synonym (a command that is to have the same effect as an existing command), 
duplicate the command line, modify the command name on the duplicated line, and add 
one to the command· line counter at the left side of the header line. To delete a command, 
delete the command line in• the member and decrease the counter by one. 


Modifying IOA Online Facility PFKey Definitions 


Every screen of the IOA Online facility is associated with a set of PFKeys with 
pre-assigned commands. It is possible to change these PFKey definitions. The PFKey 


assignments reside in the IOA PARM library in members with the following naming 
convention: 


TxxxPFl 
Active PFKey definition· member 


Where xxx is the screen identifier. Appendix E contains a detailed list of all screens and 
their corresponding PFKey members. 


A PFKey member is composed of one header line and any number of PFKey definition 
lines. 


The structure of the PFKey definition line is: 


Columns 


1- 8 


9-22 


Description 


The PFKey or <ENTER>. 


The command assigned to the PFKey. 


At least one PFKey/Enter key must be defined as the <ENTER> command. 


The IOA Primary Option Menu 


The IOA Primary Option menu displays IOA product options and facilities available to the 
user. Customizing the menu is usually not required since the menu is dynamically generated 
according to the options available to the user. 


The IOA Primary Option menu is displayed in one of the following formats: 
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• When less than' a threshold number 0£ options is available, options are displayed in, Line 
format. Options are listed one per line on the screen• For each option' an option code, the 
name 0£ the option, and, a brief description 0£ the option, is listed~ Information on the IOA 
pvoducts installed at the site is displayed in the upper right corner of the screen~ 


• When, more than the threshold number 0£ options is available, options are grouped 
according to product in Box fovmat .. In Box format only option codes and option names 
are displayed. This format enables displaying all IOA products options on one screen. 
Information on IOA products installed at the site is available via option O, 


Reducing or increasing the number of available options may change the format in which 
the Primary Option menu is displayed. 


Line Format Display 


IOA PRIMARY OPTION MENU 


(1) 


OPTION ===> 


0 


1 
2 
3 


4 


5 
6 


7 


8 
c 
x 


IOA INFO 
IOA Version Information 
MAIN MENU 
IOA Primary Option• Menu 


JOB SCHEDULE DEF 
CTM Job Scheduling Definition 


JOB STATUS 
CTM Job Status Display 


COND/RES 
IOA Conditions/Resources Display 


LOG 
IOA Log Display 


UTILITIES 
IOA On-Line Utilities 


MANUA.LCOND 
IOA Manual. conditions Display 
CALENDAR DEF 
IOA Calendar Definition· 


CMEM DEFINITION 
CTM Event Manager Rule Definition 


EXIT 
Terminate Session 


USER 
DATE 


M21 


05.05.96 


M Version· 5. 0. 0•9604 
R Version 5.0.0•9604 


PLEASE SELECT OPTION 
AND PRESS ENTER OR PRESS THE OPTION'S PFK 
12.20.43 
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Box Format Display 


(1) 


OPTION ===> 


IOA 


0 
IOA INFO 


1 
MAJ:N MENU 
4 
CONDIRES 


5 
LOG 


6 
TSO 


7 
MANUAL· COND 


8 
CALENDAR DEF 
x 
EXIT 


CONTROil-M/R 


2 
JOB SCHEDULE DEF 
3 
JOB STATUS 


C 
CMEM DEFINITION 
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IOA PRIMARY OPTION MENU 


CONTROL-DIV 


A 
MISS:CON STATUS 


M MISS:CON DEF 
R 
REPORT DEF 
T 
RECIPIENT TREE 
u 
USER REPORTS 


F 
PC PACKET STATUS 


CONTROL-B 


BB 
BALANCING STATUS 


BM 
M:CSSION DEF 
BV 
DB VARIABLE DEF 
BR 
RULE DEFINITION 


BA 
RULE ACTIVITY 


USER 
M21 


CONTROL-0 


OR 
RULE DEFINITION 
OM 
MSG STATISTJ:CS 
OS 
RULE STATUS 
OL 
AUTOMATION LOG 
OA 
AUTOMATION OPTS 


CONTROL-T 


TR 
RULE DEFINITION 


TP 
POOII DEFINITION 


TV 
VAULT DEFINITION 
TI 
INQ/UPD MEDIA DB 
TC 
CHECK IN EXT VOL 


PLEASE SELECT OPTION 
AND PRESS ENTER OR PRESS THE OPTION'S PFK 
12.20.43 


The menu is displayed according to the order of appearance of each product in the menu 
table (described later in this section). The IOA menu is always displayed' on the left side of 
the screen (displayed only ini Box format). However, changes to other menus affect the 
a1'rangement of the options 0£ other products in the menu. 


Customizing the Menu 


Options for the Primary Optioni menu a1'e listed in member MENU in the IOA MSG library. 


This member cani be used to modify the information that appears in the menu display. The 
lines in this member look like this:· 


* 
Comment 
T* 
IOA 


TMR 
CONTROL-MIR 


TM 
CONTROL-M 


TD 
CONTROL-D 


TDV 
CONTROL-DIV 
TO 
CONTROil-0 


TB 
CONTROL-B 


TT 
CONTROL-T 


L* 
* O:COA INFO 


L* 
* 1MAIN MENU 
LM 
* 2SCHEDUIIE 


LM 
* 3STATUS 


L:C 
* 4RES 
LI 
* SLOG 


L:C 
s 6'l'SO 
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IOA Version· Information• 
This Menu 


Setup Schedule 


Job Status Display 
Conditions/Resources file 


IOA Audit Trail 
Enter TSO Command 
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Where: 


T 


L 


Titles which appear at the top of each box in the Box Display Type for 
the IOA Primary Option menu. Following the letter Tis the name of 
the product whose options are to be contained in the box with this 
title .. 


Example 


The line shown below indicates the title to be displayed at the top of 
the box containing CONTROL-M options. 


TM 
CONTROL-M 


Lines beginning with the letter L indicate menu options .. The format 
for an option line in the menu member is as follows: 


Lproduct 
environment optcode optname 
opt-descripbion 


Wheve: 


plloduct 
IOA product that must be installed foll this option to 
be displayed in, the menu. Fov example, M indicates 
that the option is displayed when, CONTROL-M is 
installed at the site. I is foi.i IOA. 


environment 
Environment that IOA must be operating under for 
this option, to be displayed. Valid environment 
specifications ave: 


T 
TS© 


l 
ISPF 


0 
no environment 
* 
all' environments 


optcode 
Option code used to· activate (choose) the option .. The 
option' code can be one ov two characters in length 
and must be the same as the option code indicated 
for this option in1 the Program List member in use at 
your site. 


optname 
Option1 name. Displayed, adjacent to the option code 
in Box format 0£ the menu, and preceding the option 
description in the Line format. 


opt-description 
Option description. Displayed only in Line format. 
This can be modified. to aid option identification at 
your site (e.g., it can be translated). 


For more information, see the description that appears at the top of member MENU in the 


IOA MSG libvary. 
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Customizing IOA Screens 


Customization of IOA screens can be accomplished in a number of different ways. In this 
section the following topics are described,: 


• Modifying IOA Screens and Constants 


• Customizing IOA Display Format Members 


• Customizing Colo11 in IOA 


• Customizing of the IOA Primary Option Menu 


Note 
To avoid incompatibilities with JOA scripts, it is recommended to back up 
members modified during customization of JOA screens, and to use these 
backups for KSL scripts; 


Modifying IOA Screens and Constants 


IOA screens and constants can be adapted by the user for local language, local site 
terminology, ease of use, etc. 


IOA screen and, constant members are stored in the IOA MSG library. The naming 


convention, fo11 these members is: 


CTxSyyy 


Where 


x 
A single character indicating the product (e.g., M fo11 a CONTROL-M screen). 


yyy 
A 3;.character screen identifier. 


Each member contains definitions for either a screen and its constants, 011 a set of 
constants. Definitions are specified as Assembler macro instructions. Each member must 
be assembled and link-edited to create a CSECT and module with a name identical to the 
screen member name. The load module containing the screen replaces an existing CSECT 
in one or more load modules in, the IOA LOAD library. 


A screen, is defined by the following macros: 


CTMSSTA 


CTMSBLK 


CTMSFLD 


CTMSEND 


Start screen/constants definition (one CTMSSTA macro for each 
screen, definition). 


Start a block of fields/constants. 


Define a field in the screen/constant. 


End screen/constant definition (one CTMSEND macro fo11 each screen 


definition~. 


Each unit of data in an IOA screen is called a block. A block may contain one or more 
fields. 
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Example 


• The header block is composed of two 011 more lines which contain the header line, the 
command field, the scroll field, etc. 


• The following line which appears at the top 0£ the CONTROL-M Job List screen is a 
block. 


'====>>>>>> TOP OF ACT~VE JOBS LZST <<<<<<====' 


Within each block, the location: of the fields can be changed. It is possible to change the 
length of fields which a11e defined as skip protected and contain constants. Do not change 
the length 0£ unprotected data fields unless specifically mentioned otherwise in the 
member. The length is the length 0£ the field, not including the attribute byte. The total 


accumulated length 0£ the fields within the block which describes screen: line(s) should 
remain the same after modifications have been made .. This restriction does not apply to 
blocks used for defining constants. 


Each block is line-oriented so that the total length of each block must be the number of 
lines in the block multiplied by the length of the line. 


Do not change the location and contents o£macros CTMSSTA, CTMSBLK, and CTMSEND. 
Changes can: be applied only in the contents (parameters) 0£ macro CTMSFLD. 


Macro CTMSFLD defines a field in the screen. The fo11mat is: 


CTMSFLD 


NAME = field name 


LTH=m1 


ATTR= code, 


DATA = 'text' 


PROF=Y 


Constant Blocks 


If a name has be specified, do· not change it. 


Length without attribute byte. If not specified, the length 0£ the 
DATA text will be used. The real length 0£ the field is always one 


mo11e than that specified in the LTH field to account for the 
attribute byte. 


Field attributes. Refer to macro CTMSATT in the IOA MAC 


library. 


The data in the field (if any) in quotes. 


The value of the field upon exiting the online environment will be 
saved: in the user's p11ofile member and will be used at the next 
invocation of the environment. 


Default:·N. 


Valid values are Y or N. 


Note 
Not all fields may· use profiled values. 


Blocks used to define constants in, SYSIN input DD statements, as part of a message, 011 as 
statuses on screens, are different from: screen field blocks. You can, change the length 0£ the 
fields, disregarding the "total block length rule." An example is member CTMSAES, which is 
used to define parameter syntax of the CONTROL-MAutoEdit Simulation facility. 
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Recommended Steps for Screen Modification 


Sources (screen members) of IOA products are modified via an SMP/E USERMOD. Use the 


following steps to perform this task: 


1. Choose a name for a new USERMOD (to be built in' the following steps). The name of 
the USERMOD must be 7 characters in, length, must begin, with ani alphabetic character 
(i.e., not a number or symbol), and must be unique. 


2. Create a new member in the IOA MAINTI:..IB library with the same name as the 


USERMOD created in Step 1. 


3. Copy the contents of member UMODSRC in the IOA JCL library to the newly-created 
member. This member contains a skeleton sample for the USERMOD (to be customized 
in the following steps). 


4. Specify the name of the new USERMOD in the ++USERMOD statement. 


5. Determine the FMID and the RMID of the screen source via SMP/E Online option 3.2. 


Specify SRC as the entry-type, and the name of the screeni source as the entry-name. 


Specify the FMID in the ++VER statement. 


If the RMID value is not the same as the FMID value, add the RMID value to the 


++VER statement via the PRE(rmid;.value) parameter. 


6. Specify the screeni source-name in the ++SRC statement. 


7. Copy the contents of the source member to the line immediately after the ++SRC 


statement. Update the copy to meet your needs. 


8. Specify the name of the USERMOD in,job UMODRACK in, the IOA JCL library. Run the 
job. This job RECEIVEs and APPI'..Y-CHECKs the USERMOD. 


Job UMODRACK must end with a completion code of 0. 


9. Specify the name ofi the USERMOB in, job UMODAPP in the IOA JCL library. Run the 
job. This job applies the USERMOD. 


Job UMODAPP must end with a completion code 0£ 0. 


Customizing IOA Display Format Members 


In certain IOA product screens, it is possible to specify the display type (011 fo11mat) of the 
screen. A wide selection of predefined display types is provided. For example, in the 


CONTROL-D User Report list, display type Sis similar to IBM's SDSF, while display type 
J can be used for production control' and programmers .. Refer to the appropriate User 


Manual for details. 


If the provided predefined types are not adequate, users may define their own display 
types using the Display Type Editing facility. The following pages describe parameters 
which define new display types 011 modify existing display types. 
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AH of the display formats are defined in members in the IOA MSG library. For a list of 
these members, refer to Appendix E which contains a list of all the options of IOA and the 
screen member and/or format members which are used to build the IOA panels. For 
example, in CONTROL-D, the display formats ofi option U are defined in members $$FRM 
and: $$USR in the IOA MSG library. These members contain: sets of predefined display 
formats. The user can: add new formats in these members, or modify existing ones. When a 
display type is activated; it first checks fov any errors, which are displayed in an 
appropriate screen~ 


Each line in a format member is of a certain type. The line type must be written in 
positions 1-10 ofi the line. 


The permitted line types are: 


@STYLE 


@HEADER 


@LINE 


@FIELD 


@VAL 


@END 


@IlLM 


A line starting with an asterisk (*) is a comment line. 


The parameters on the line characterize the line's attributes. Parameters can be written, in, 
positions 11-72 of the line. A continuation line can be created, by leaving the "line type" 


area blank, and by using positions 11-72 on the new line for parameters describing the 
line's attributes. 


Each line type, and its parameters, are described below: 


@STYLE 


@STYLE is a line type used to start a new display format. The valid fovmat for a @STYLE 


line is: 


@STYLE 


Where: 


ID 
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ID=id; TYPE=type; CLASS=class; [IDLIKE=idlike; 
TYPELIKE=typelike; CLASSLIKE=classlike;] LTH=n; 


Name of the display type .. This value can be used to identify the 
DISPLAY TYPE field in an option's entry panel (if one exists) o:v 


when changing the Display Type by specifying the command 
DISPLAY x (where xis the display type) from the command line. The 
value can be any printable character. A blank is not valid. This field 
must be one character in length only. The character 'l' is reserved fov 


internal use and should not be used. 
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TYPE 


CLASS 


ID LIKE 


TYPE LIKE 


CLASS LIKE 


LTH 
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Logical type ofi the display type (second level qualifier). Valid values 
depend on the screen in, which the display type is used'. For example, 
display types of the CONTROL-D User Report List screen use this 
field fol' the following valid file types: 


p 


A 


H 


* 


Permanent file 


Active file 


History file 


All file types 


Class of record for which, this display type is used. Valid values 
depend on the screen in which the display type is used. For example, 
display types of the CONTROL-D User Report List screen have the 
following valid record classes: 


U 
User reco11ds 


S 
Sysdata reco11ds 


R 
Ruler reco11ds 


* 
All recovd classes 


Name ofi the display type to which the current ID is identical. 


TYPE LIKE and CLASSLIKE must also be specified .. The definition of 


the display type specified via parameter IDLIKE must pvecede the 
current line. When this parameter is specified the cuvrent display 


fol.'mat should have only a @STYLE line, and, take its definition from 


the specified display format. This field must be one character in 
length only. 


Type of the display type to which the current ID is identical. Valid 
values are the same as in the TYPE pal'amete11. 


Class of record fol' which this display type is used. Valid values are 
the same as in the CLASS parameter (described above). 


Length of the line to be displayed. Valid values are 80 or 132. 


Color parameters can also be modified. Refer to "Color Parametel's" below. 


@HEADER 


@HEADER is a line type used to describe the header line of the current display format. 
The valid fo11mat for a@HEADER line is: 


@HEADER 


Where: 


DATA 


DA'l'A=data; 


Actual header data, to be displayed as the header line of the screen in 
which the display type is shown. The header data can be a maximum 


of 80 (or 132) characters in length. If less data is specified, it is 
padded with blanks to fill the physical line. 
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Colo11 parameters can also·be modified. Refer to·"Color Parameters" below. 


@LINE 


@LINE is a line type used to start a new line in the current display fo11mat .. The valid 
format for a@LINE is: 


@L:CNE 


Where: 


LONG 


SNOWBLINE 


LONG={YjN}; SHOWBL:CNE={YIN}; 


Whether 011 not the line should be displayed. in regular screen fo11mat 


(i.e., when Additional Info11mation is not requested on the line). 


N (No) 


Y (Yes) 


Always display the line. Default. 


Displayed the line only when' ADDITIONAL INFO is 
selected on the displayed line. (ADDITIONAL INFO is 
requested by entering A in the line's option field). 


Whether 011 not the line should be displayed when all fields in it are 


blank 


Y (Yes) 


N (No) 


Show the line. Default. 


Do not show the line .. 


Color parametens can also· be modified~ Refer to· "Colo11 Parameters" below. 


@FIELD 


@FIELD is a line type used to start a new field in the current line in the current display 
format. The valid format for a @FIELD is: 


@F:CELD 


Where: 


NAME 


DATA 


LTH 


PREF 
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NAME=name; DA'l'A=data; L'l'H=ln·; PREF=pref; KANJ:C={YjN}; 
OFFSE'l'=ofst; EDI'l'={YjN}; DEFAUL'l'EDI'l'={YIN}; DFL'l'=dflt; 


Field to be displayed. Valid names are listed in the description of the 
display types ofi each product. 


Constant data to be displayed. This is useful, fo11 example, fo11 


displaying a field descriptor. Either NAME or DATA must be p11esent, 


but not both. 


Display length of the information of the field specified in the NAME 
parameter, or the display length of the constant information in the 
DATA parameter. If the actual information provided by NAME or 
DATA is too sho11t, it is padded with blanks on the right. If the 
information. is too long, it is truncated on the right. 


Prefix to be added to the left of the displayed data specified by NAME 
or DATA. 
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Specifies if Kanji (Japanese writing using Chinese characters) input is 
allowed. 


Y (Yes) 


N (No) 


The current field allows input in Kanji format. 


The current field does not allow input in Kanji format. 
Default .. 


Offset in the data field from which data should be takeni for screen 
display purposes. This mechanism allows the user to split a long data 
field between several display fields (maybe on several different lines). 
n is the offset from which to start. 


Whether or not the displayed. field· should be updatable. Valid only if 
NAME is specified. 


N (No) 


Y (Yes) 


The field is displayed in a protected (cannot be 
modified) fo11m. Default. 


The user can change the displayed field. 


Whether or not the user should be able to edit an inse11t record. Valid 
only if NAME is specified. 


N (No) 


Y (Yes) 


The field is displayed in a protected (cannot be 
modified) form, Default. 


For an Insert record the field is displayed so· that the 
user can enter initial info11mationi fo11 it. 


Default value for the field in an insert line. Valid only if NAME is 
specified. The data specified is displayed in the field. If DFLT is 
omitted, the initial value of the field is blank. 


Color parameters can also be modified. Refer to "Color Parameters" later in this section. 


@VAL 


@VAL is a line type used to set the color of the current field according to the value of the 
field. More than one @VAL line type can be specified for different values of the current 
field. The first match found between the field's value and the value specified in the @VAL 


line determines the color of the field. 


The valid fo11mat of a @VAL line is: 


@VAL 


Where: 


DATA 


DATA=data 


Specifies data which should be compared to the current value of the 
field. The data may contain* and? mask characters. 


Color parameters must also be specified, In case of a match between the current field~s 


value and data in the @VAL line, the colo11s specified in the @VAL parameter will override 
the colo11s specified in the @FIELD line. 
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@END 


The @END line type is used to end the definition' of the current display fo11mat. 


@DLM 


The @DLM line type is used to change the currently used delimiter in this member to a 
new one. The default delimiter is; This line can be inse11ted anywhere in' the member. The 
valid fo11mat fo11 a @DLM line is: 


@DLM=newold 


Where: 


new 


old 


New delimiter. 


Old delimiter. 


In the @DLM statement the new delimiter is specified as the value for the DLM keyw.011d, 


and is delimited by the old delimiter. 


Example 


@DLM=,; 


@DLM=&:, 


@DLM=;&: 


<<----- delimiter first set to , 
<<----- delimiter then set to &: 
<<----- delimiter set back to ; 


Color Parameters 


The @STYLE, @LINE, @FIELD and @HEADER line types suppo11t COLOR and HILITE 
parameters .. Colors take effect on colo11 monitors only. On monochromatic monitors, the 
highlight takes effect. 


Valid' colo11s are: 


NONE (Default) 


WHITE 


BLUE 


GREEN 


TURQ 


RED 


PINK 


YELLOW 


Valid highlights are: 


NONE (Default) 


BLINK 


US<I!ORE 


REVERSE 


DARK 
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Users can create a combination of color and highlight for each field by specifying COLOR 


and HILITE parameters on the @FIELD line. 


In case of monochrome monitors, users can add the INTENS parameter to the @FIELD 
line type. 


Valid intensities are: 


LOW (Default) 


HIGH 


The COLOR, HILITE, and INTENS parameters can all be specified. Each takes effect 
when appropriate. 


If the above parameters are omitted on, the @FIELD line, the field inherits those 
parameters from the @LINE preceding it. 


If the above parameters are omitted on, the @LINE line, the line inherits those parameters 


from the @STYLE preceding it. 


If the above parameters are omitted on the @STYLE line, they are set to their default values. 


@STYLE, @LINE and @FIELD also accept the COLORA and HILITEA parameters that 
accept a range of values similar to COLOR and HILITE, respectively. These parameters 
can be used to specify a set of alternate· colors when displaying records: the first recoDd on 
the screen is displayed with COLOR and HILITE; the second record is displayed with 


COLORA and HILITEA; the third record with COLOR and HILITE, and so on. This can 
cause an alternating color effect. If COLORA and HILITEA are omitted, the alternate 
colors aDe set to be identical to the standard color values. 


Extended Color Support 


The following should be considered when using the extended, color feature of the IOA 
Online facility: 


ISPF Characteristics 


Due to ISPF characteristics, adjacent fields with different colovs are separated. by a byte 
without color (black). Therefore, some IOA screens have a different appearance under 


ISPF than under other Online environments (e.g., native TSO, CICS). 


IMS/DC and IDMS/DC 


IOA does not automatically recognize an IMS/DC or IDMS/DC terminal as supporting 
extended coloD attributes. If the IMS/DC or IDMS/DC terminal supports extended color 
attributes, the ICOLOR=YES parameter must be added to the user's profile. For details on 
modifying the user's pnofile, refer to "Profile Variables" later in this section .. 


It is impovtant not to use parameter ICOLOR=YES fo11 non-color terminals .. Doing so will 
cause an error and the terminal will be inhibited. 
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COM-PLETE 


At this time, IOA does not support extended color attributes under COM-PCETE. In a 
future release 0£ IOA, color support for COM-PLETE will be added. 


IRMA PC Terminal Emulator Users 


Early versions of IRMA (from DCN'') have a problem interpreting the 3270 color stream. 


As a result, IOA screens may appear with inco11rect coloration~ If you encounter this 


problem,. call: youv local IRMA support representative and request a later version of 


IRMA™ that corrects this problem, 


Customizing Extended Color Support 


The IOA environment uses extended color support if the terminal is capable of supporting it. 


Various defaults aDe set so that ifino changes are made, extended color is used wherever possible. 


Two VTAM commands can be used to help determine whether or not a particular terminal 
supports color: 


• RPQ 


This is a VTAM command which can be issued to a terminal, and which causes the 
terminal to respond with an indication, whether or not is suppovts extended color. 


Note 
This command is a physical command, and is therefore not supported by 
certain older control units. 


• LOG-MODE 


This is an entry in one of the VTAM tables, which logically defines the capabilities of a 
terminal. The following table indicates that the capability of the terminal to support 
extended colo11 is determined by the contents of the VTAM LOG MODE entry: 


Native TSO and 
RPQ 
IOA, i£ 
TCOll.OR= YES or 
TCOLOR=NO 
ROSCOE 
TCOl!.OR=TER NO 
MIN AL 


TSO and' 
RPQ 
IOA 
ICOI'..OR=NO 
ROSCOE 


(Cross-Memory) 


ISPF 
RPQ 
ISPF 
NIA 
LOGMOilE 


IOAVMON 
RPQ 
IOAVMON 
LOG MODE 


IMS/DC and 
ICObORnoissued~ 
ICOLOR=NO 
IDMS 


CICS 
RPQ 
IOACICS 
ICOLOR=NO 
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In the previous table, TCOLOR and, !COLOR are IOA Profile variables. See "TOA 
Profiles" in this section for more information about these variables. 


Note 
For TSO I ROSCOE Cross-Memory and CICS, the appropriate change must be 
applied before the !COLOR variable is activated. 


IOA Access Method 


Several IOA products include files that are processed using an internal component called 
the IOA Access Method~ 


The IOA Access Method is used to create indexed (keyed) file structures that offer 
enhanced data integrity. IOA Access Method files are physical sets ofi sequential datasets 
which are allocated, formatted and accessed by IOA products via IOA Access Method 
utilities .. 


Most IOA Access Method files consist of two separate sequential datasets: 


• A data component, where the actual record information resides. 


• An index component, which provides keyed access to records in the data component. 


Certain IOA Access Method files may contain only an index or data component. 


Both index and data information are stored in compressed format, resulting in reduced I/O 


processing overhead and optimum disk space utilization. 


The IOA Access Method provides Dual Mirror Image file suppo11t. For example, this 
mechanism enables to quickly recover from a disk crash, if the crash occurred on a disk 
that contains the IOA Access Method p11imary file. 


File Structure 


IOA Access Method index components contain fixed length index records .. IOA Access 
Method file data component records can be either fixed 011 variable length. 


The first block in each IOA Access Method' file extent consists of a control record, which 
contains a bit table indicating the blocks within the extent that contain free space for 
additional records. 


IOA Access Method index files function, as balanced tree index structures. 


In addition to index (key) and data reco11d pointer fields, IOA Access Method file index 
component records can contain non-key data, enabling non-key selection criteria to be used 
without accessing the associated Access Method file data component. Non-key data fields in 
index records can, be stored in compressed format, providing maximum space utilization 
benefits. 
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Examples. 


• CONTROL-D User Repovt list files are indexed by recipient name, job name and record 
creation timestamp. 


• CONTROL-B Group Definition files are indexed by group name. 


Data and index components may extend beyond one physical, dataset. Initially, however, a 
component is allocated as a single physical dataset called the pl!imary extent. 


To increase an IOA Access Method file component's capacity, a maximum of 255 secondavy 


extent datasets can be allocated and formatted. Using an IOA Access Method definition 
option, secondary extent allocation and formatting can 
1 automatically be performed when 
an' out-of-space condition occurs. 
· 


Note 
Currently, secondary extents are supported only·in CONTROL-D and CONTROL-V. 


JOA Access Method Naming Conventions 


IOA Access Method files which a:r:e allocated during CONTROL-D, CONTROL-V and 


CONTROL-B installation are listed below and use the following naming convention: 


prefix.dbname.Ennn 


Where: 


pvefix 


dbname 


Ennn 
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IOA Access Method file name pvefix. The prefix is specified during 
product installation by setting relevant installation variables 
(e.g., DBPREFB for CONTROL-B, and DBPREFD for CONTROL-D 


and CONTROL-V). 


Example: CTD.PROD 


Note 
The prefix may contain more than one qualifier. 


IOA Access Method file identifier name. The identifier name is 
specified during product installation as part of the name assigned by 
the parameter DSN in the Access Method file's definition statements. 


Fov example, identifier name ACT is assigned to the CONTROL-D 


Active User Report list data component while ACTI' is assigned to the 


CONTROb-D Active User Report list index component. The identifier 
name of an Access Method file should never be modified. 


Extent sequence number suffix generated internally by IOA Access 
Method management routines whenever an Access Method file 
component is allocated. The suffix consists of the letter E followed by 


nnn1 a number from 000 to 255, indicating an Access Method file's 
extent sequence number. A maximum of 256 physical file extents can 
be associated with each IOA Access Method file. 
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CONTROL·B Files Supported by the IOA Access Method 


CTB.PROD.GRPD.EOOO 


OTB.PROD .GRPl'.EOOO 


CTB.PROD.JAFD.EOOO 


CTB.PROB.JAFl.EOOO, 


CTB.PROB.MODD.EOOO 


CTB.PROD.MODl.EOOO 


CTB.PROD.REPD.EOOO 


CTB.PROD.REPl'.EOOO 


CTB.PROD.V ARD.EOOO 


CTB.PROB.V ARl.EOOO 


CTB.PROD.ABF.EOOO 


CONTROL-B Group Definition, file data component. 


CONTROL-B Group Definition file index component .. 


CONTROL-B Rule Activity file data component .. 


CONTROL-B Rule Activity file index component. 


CONTROL-B Basic Parameters file data component. 


CONTROL-B Basic Parameters file index component. 


CONTROL-B Report file data component. 


CONTROL-B Report file index component. 


CONTROL-B Variables Generation file data component. 


CONTROL-B Variables Generation file index component. 


CONTROL-B Active Balancing file data component. 


CTB.PROD.ABFBKP.EOOO 
CONTROL-B Backup Active Balancing file data component. 


CONTROL-DIV Files Supported by the IOA Access Method 


CTD.PROB.HST.EOOO 


CTD .PROD.HSTl.EOOO 


CTD.PROD.ACT.EOOO 


CTD .PROD.ACTl.EOOO 


CTD.PROD.PRM.EOOO 


CTD .PROD .PRMI.EOOO 


CTD.PROD.MIG.EOOO 


CTD .PROD.MIGl.EOOO 


CONTROL-D History User Report list data component. 


CONTROL-D History User Report list index component. 


CONTROL-D Active User Report list data component. 


CONTROL-D Active User Report list index component 


CONTROL-D Permanent User Report list data component. 


CONTROL-D Permanent User Report list index component. 


CONTROL-V Migrated User Report list data component. 


CONTROL-V Migrated User Report list index component. 


Note 
Jobs or procedures using JOA Access Method files should contain a DD statement 
only for the first extent of the primary file .. All other extents are dynamically 
allocated when the JOA Access Method file is opened. 


File Utilities 


A comprehensive set of utilities is provided for IOA p11oducts which use IOA Access Method 
files. These utilities are used to create and maintain IOA Access Method files .. 


l©ADBF 


IOADIG 


IO AD II 


IOADPT 


IOADCPY 


Allocates and formats an IOA Access Method file's index or data component. 


Verifies the integrity of an IOA Access Method file's data component. 


Verifies the integrity of an IOA Access Method file's index component. 


Prints an· IOA Access Method file's data and index component records 
in SNAP dump format. 


Copies an TOA Access Method file from the dual mirro11 image file to the 
primary, as well as from the p11ima11y file to the dual mirror image file. 
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IOADLD 


IO AD NL 


Loads an IOA Access Method file's contents from a sequential file. 


Unloads an IOA Access Method file's contents to a sequential file. 


Note 
Products which use the JOA Access Method contain additional utilities which are 
specific to the product. For more details about additional JOA Access Method 
utilities, refer to the summary list of utilities in Section 9. 


File Definition Statements 


When' allocating and fo11matting an IOA Access Method file (i.e., via utility IOADBF), a 


lib11ary member containing IOA Access Method File Definition statements is read. 


These statements define an IOA Access Method file's physical, and Iogical attributes, such 
as dataset name, unit, volume parameters, space pal'ameters, record key length (fo11 IOA 


Access Method file index components), and whether additional file extents are allocated 
automatically or manually when the current file extent is full. The members reside in the 


IOA INSTCTx library, where xis a one-letter p11oduct ID. 


Examples 


• The IOA Access Method File Definition· statement for CONTROL-D's Histo11y User 


Repovt list components can be found in the DEFHST and DEFHSTI members in, the 


IOA INSTCTD librai;y. 


• The IOA Access Method File Definition statement for CONTROL-B's Group Definition 
components are the DEFGRPD and DEFGRPI members in the IOA INSTCTB library. 


The IOA Access Method file's attributes are kept in the file's control block. If you need to 
change these parameters after the file is created, modify the Definition Statements 
member, and· run utility IOADBF (with FUNC=CHANGE). 


Fo11 more information on IOA Access Method File Definition statements, refer to Utility 


IOADBF in' Section 9. 


Dual Mirror Image File Support 


Each IOA Access Method file can be created with dual mirror image file support. Foi; each 
logical extent 0£ the file, the IOA Access Method automatically allocates a dual extent of 
the same size. The name ofi the dual extent is identical to that of the co11responding 
primary extent, except for the first character of the last qualifier which is set to D instead 
of E (e.g., prefix.dbname.Dnnn). 


The dual mirrov image file is created if parameter DUAL in the IOA Access Method 
definition member is set to Y. See the explanation on utility IOADBF in· Section, 9 of this 
guide. The definition member also specifies the unit and volume names fo11 the dual file 
allocation. It is highly recommended that different volumes be used, for the primary and 
dual files fo11 imp11oved perfo11mance and recovery. 


The IOA Access Method synchronizes the primary and dual files. All read 
1 opevations are 


perfo11med only from the primary file, and all: write operations are performed in parallel' to 
both files. The dual· file is allocated dynamically. It is recommended to activate the dual 
mirror image suppo11t only fo11 the IOA Access Method data component, and not for the 
index component. 
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Dual Mirror Image File Parameters 


The following parameters are used to manage the dual mirror image file: 


• DUALM 


If the DU ALM parameter is set to Y and an error occurs in the dual' mirro11 image file, 
the current operation fails fo11 the primary file as well; and a manual correction should 
be made before any further p11ocessing is done. If the DUALM parameter is set to N, the 


p11ocessing continues for the p11imary file only, without dual mirror image file support. 


• DUALST 


An additional option of the dual1 mirro11 image is an internal' timestamp ·checkpoint to ensure 
that the primary and dual 1 copies are fully synchronized with each other. This ensures 
greater data integrity but at the same time increases the I/O processing overhead. 


This option is activated if pa11amete11 DBALST in the IOA Access Method definition 
member is set to Y during file creation. If the timestamp values are not synchronized 
between the prima11y and dual files, the dual file should be rebuilt. See the explanation 


fol' utility IOADBF in, Section' 9 of: this guide for additional information. 


Recovering From a Damaged IOA Access Method File 


If the IOA Access Method is used 
1 with dual file support, and one of the two copies is co11rupt 


or becomes unavailable, the damaged file can' be resto11ed by using utility IOADCPY. This 
utility copies all the extents of the wo11king copy to· the corresponding extents of the 
corrupted copy. See Section 9 ·of this guide for more information' about this utility. 


IOA Profiles 


A pl'ofile is a set of values to be used for certain· fields in IOA screens, that are used as 
default values during sessions of a specific user or group 0£ users (e.g., the lib11ary name 
field in the Job Scheduling Definition entry panel, or a show screen filter). 


The IOA Online environment provides the following types of profiles. 


• The Global p11ofile, which can be customized by the system administrator only. This 


p11ofile serves as the default setting for all users in the Online environment. If the user 
profile does not indicate a setting for a specific field, or does not provide a value fo:r a 
specific variable, the value specified in the Global profile is used. 


The Global· Profile also contains screen' filter definitions that can: be used by any user in 
addition to the pl'ofiles that are defined in1 his/her user pl'ofile. 


The Global profile is a combination' of the default values in member $PROFFLD, and the 
overriding specifications in member $PROFMOD. (See "Profile Members" in this section). 


• User profiles are defined for users or specific groups of users. These profiles can include 
menu definitions and user-defined filters (described below) .. Settings in the User p11ofile 


override the settings in the Global profile. 
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Profile Members 


Global profile information is stored in the following members found in the IOA PARM 


library. 


$PROFFLD 


$PROFMOD 


$PROFVAR 


Contains the default settings for the IOA Online environment. This 
member is supplied with IOA and1 should not be used for 


customization~ This member also contains a line that indicates the 
location of the User Profile members .. 


Contains global customization information. The member can contain 
the follbwing types of information. 


• Global filter definitions. 


• User profile locations. If specified1 these override the location of the 


User profiles specified: in member $PROFFLD. 


• Values to override the default values for fields specified in member 


$PROFFLD. 


This member can be copied so that customization need not be 
redefined when upgrading from a previous release. 


Contains the values specified: for 
profile variables (runtime 
parameters). The values of all profile variables are maintained via 
ICE (Installation and Customization Engine). See "Profile Variables" 


in this section for move infovmation, on the variables in this member. 


User profile members are located in libvaries specified in member $PROFFLD, and 
optionally, in 
1 $PROFMOI:>. These libravies are listed in the lines beginning with a dollar sign 
($) in the $PROFFLD member. It is possible to divide the user profiles at your site into more 
than one library. By default the following line is included in member $PROFFLD: 


$* 
=%0IIPREFA%.PROF 


This line indicates that all user pvofiles are found in the PROF library with the prefix of 
the dataset in which IOA was installed~ 


User pvofiles can be divided into more than one library. For example: 


$M* 


$N* 


=%0LPREFA%.PROFM 


=%0LPREFA%.PROFN 


May be used: to direct all User pvofiles beginning with M to be stored in the PROFM 


library and User pvofiles beginning with N to be stored in1 the PROFN lib11avy. 


As shown, mask characters (* and ?) can be used in 1 the specification of the user names 
(profiles) to be stored in a specific library. 
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Profile Contents 


The following types of lines can appear in a profile member: 


• Lines that contain an asterisk(*) in column one are remark lines .. 


• Lines that contain a dollal' sign ($) in column one indicate user profile libraries 
(described above). 


• Lines describing either variables, fields or filter fields. These are called Profile Symbol lines. 


The format of a symbol line is described below: 


Columns 1-8 


Column9 


Columns 10-1 7 


Column 18 


Columns 19~ 72 


Example 


Profile symbol (field) name. Mandatory. 


Period. (Mandatory only if a Filter name follows.) 


Filter name. Optional. Default: blank. 


Equal sign(=). Mandatory. 


Profile symbol value. (Blank is a valid value.) 


The· line shown below is a regular field line (not a filter). 


SRLBL:CB 
=%0LPREFB%.RULES 


Example of a Filter 


The following lines describe a global filter ENDNOTOK, which, when activated, will 
display aU ended NOTOKjobs fromi option 3 (Job Status). 


SSTA700 .ENDNOTOK=N 


SSTA704 .ENDNOTOK=N 


Considerations for Profile Symbol Lines 


• Values for Profile variables are specified in1 I CE (using the Cl:JSTO MIZE option for I OA 


in the IOA Installation Main Menu). The values are stored in member $PROFVAR in 
the PARM library. See "Profile Variables" later in this section for details on what values 
to specify for the Profile va11iables via ICE. 


• Field lines contain values to be used for fields in IOA that are not part of a SHOW 


window (e.g., a library name in a rule/job/mission definition entry panel). Field lines 
may be located in any of the following members: 


$PROFFLD 


$PROFMOB 


$userid 


The field line indicates the default value supplied with the IOA 


installation. 


The field line indicates a value specified as part of on-site 
customization' of the Global profile .. Field line specifications in 


$PROFMOD override specifications in1 $PROFFLD. 


The field line indicates a value specified as part of a user profile. 
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• Filter field lines specify values fol' selection criteria fields in Show Window filters (e.g., 
Y Ol' N for field UTILITIES in the IOA Log Show Screen' Filter window, which indicates 
whether or not messages resulting from CONTRO!:,-T utilities should be displayed). 


SHOW Window Filters 


A filter is a set of values for fields in a show window. The user can name a set of; values 
and activate a filter at a later time by specifying the following command in the command 
line of the relevant screenc 


SHOW filtername 


Filters that are saved by a specific user are stored in1 that user's User Profile member. To 
add a filter to the Global profile,. perform the following steps: 


l. Create and save the filter in the nol'mal way (i.e., in your User Profile member). 


2; Copy the lines containing the name of the filter from your User profile to the Global 
Profile member ($PROFMOD). 


Some default filters are provided in member $PROFFLD. 


Note 
JOA filters are currently available for options 3 and 5 in the JOA Primary Option 
menu; See the descriptions of these options in the product-specific user manual(s) 
for more information on JOA filters. 


Profile Attribute in the Screen Definition 


IOA is installed with pl'ofile attributes assigned to various fields .. If you wish to change 
these defaults, read the follbwing paragraphs. 


A field can be defined with a profile attribute by adding the parameter PROF= YES to the 
field macro definition' in' the screen definition member in the MSG libraey. For example: 


CTMSFLD NAME=SSCHROL,ATTR=UH,LTH=4,PROF=YES 


For instructions on how to appl:v a change to the screen format, see "Recommended Stages 


of Screen' Modification~' eadier in this section. 


Under certain screens, parameter PROF takes a different fo:rim .. Instead 
1 of; YES, it 
designates the name of the profile variable. (When' YES is used, the field name is used as 
the Profile Variable name.) If you want to change the profile attributes of these screens, 
consult your IOA representative .. 


Note 
The JOA profile capability can be applied to fields in the header, footer, and 
windows of each screen, but not to fields which appear as part of a scrollable area 
on the screen. If yow wish to apply the profile capability to a field in a scrollable 


area; consult your JOA representative. 
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Saving a Profile 


A profile is saved by writing it to the user profile library in a member name identical' to 
the user ID (the Online environment session ID, e.g., TSO user ID) only when the user 
exits the IOA Online facility, and only in case of normal termination. 


Note 
If the profile library is full, the attempt to save a User profile fails with a D37 abend. 
It is therefore recommended that the profile library be compressed regularly. 


Profile Variables 


Follow the Majo11 and Minor steps in ICE to specify values for the Profile Variables. If you 
are not familiar with the ICE application~ refer to the IOA Installation Guide. 


To change the value of a Profile variable, use the CUSTOMIZE option in the IOA 


Installation Main menu. 


When IOA is installed, all Profile variables receive a value. Values for the profile are first 
stored in ICE tables (!SPF tables). These values are copied from the ICE tables into the 
parameter members once all ICE steps are performed. 


ICE allows referencing of p11evious settings of Profile variables specified in other (previous 
or current) environments of IOA. When installing a new IOA environment , it is possible to 
automatically retrieve the predefined settings at your site. A default value is provided for 
any new profile variables that are not referenced. 


When updating the pavameter values, ICE verifies that the values stored in the ICE tables 
are the most current values .. The values are verified using an internal comparison 
mechanism that compares the values in ICE and the values in the target parameter 
members .. 


If all values are identical, processing continues. If conflicts are identified, a screen is 
displayed listing the parameters fov which the values in ICE are different than the values 
specified in the parameter members. You can select which version of the parameters is 
required, and either retain the current values in1 ICE or copy the values from the 
parameter member into ICE. 


Notes 
Differences between ICE tables and parameter members can occur when the user 
updates values in ICE and exits without updating the parameter member, or when 
the user updates the parameter member outside ICE. 


If no value is specified, a default value is provided for each profile variable. A full 
list of the Profile variables and their defaults appears later in this section. 
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To change the value of a Profile variable, perfo11m the following steps in1 ICE: 


1. Specify IOA as the Product ID. 


2 .. Select ClJSTOMIZE (Option' 7) from the Main menu. 


3. Select Majoii Step 3, "Profile Variables." 


4 .. Select the type of variable. 


5. Locate desired variable and specify the required value. 


Note 
Online help is available for each variable specified via ICE. Detailed explanation 
for each variable is provided later in this section. 


Window Display Variables 


SABKWND 


/v' SAPRWND 


il. SARSWND 


\__';<SDECWND 
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Controls whether or not to display the Save confirmation window 
when a request is made to update a backup mission from the 


CONTROL-D Active Mission screen (screen A.Z). 


Y (Yes) 


N (No) 


A confirmation· window is displayed. 


The backup mission is p11ocessed without prompting the 
user for confirmation. Default. 


Controls whether or not to display the Save confirmation window 


when 1 a request is made to update a printing mission from the 


CONTROL-D Active Mission: screen (screen A.Z). 


Y (Yes) 


N (No) 


A confirmation window is displayed. 


The printing mission is processed without prompting 
the user fo11 confirmation. Default. 


Controls whether or not to display the Save confirmation, window 
when' a request is made to update a resto11e mission from the 


CONTROL-D Active Mission screen (screen:A.Z). 


Y (Yes) 


N (No) 


A confirmation window is displayed. 


The restore mission is processed without p11ompting the 
user for confiiimation. Default. 


Controls whether or not to display the Save confirmation window 
when a request is made to update a decollation: mission, from the 


CONTROL-D Active Mission, screen (screen A.Z). 


Y (Yes) 


N (No) 


A confirmation: window is displayed. 


The decollation mission is p11ocessed without prompting 
the user for confirmation. Default. 
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Controls whether or not a confirmation window is displayed when a 
request is made to rerun a job from the CONTROL-D Active Missions 
screen (screen A); 


Y (Yes) 


N (No) 


A confirmation window is displayed. Default. 


The request to rerun a job is processed without 
prompting the user fo11 confirmation. 


Controls whether or not a confirmation window is opened when a 
request is made to delete an entry from the CONTROL-D Active 
Missions screen (screen,A). 


Y (Yes) 


N (No) 


A confirmation window is displayed. 


The request to delete an entry from the Active Missions 
screen' is processed without prompting the user for 
confirmation,. Default. 


Controls whether or not a confirmation window is displayed when 1 a 
request is made to add a prerequisite condition from the CONTROL-D 


Why screen (screen A.?). 


Y (Yes) 


N (No) 


A confirmation window is displayed. 


The add request is p11ocessed without prompting the 
user for confirmation .. Default. 


Shows the Reset confirmation window in the CONTROL-0 Message 


Statistics screen (screen' OM~. 


Y (Yes) 


N(No) 


A confirmation window is displayed. Default. 


The Reset is processed without prompting the user for 


confirmation. 


Controls whether or not a confirmation window is opened when a 
request is made to confirm a rerun for a job placed, in the Active Jobs 
file 
(screen 3' with the status of WAIT 
CONFIRMATION 
(CONTROL-M without CONTROL-R). 


Y (Yes) 


N (No) 


A confirmation window is displayed. Default. 


An attempt is made to rerun the job without p11ompting 


the user for confirmation·. 


Controls whether or not a confirmation window is opened when a 
request is made to confirm a rerun' for a job (CONTROL-M without 


CONTROL-R). 


Y (Yes) 


N (No) 


A confirmation window is displayed. Default. 


An attempt is made to rerun the job without prompting 
the user for confirmation .. 
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Controls whether or not a confirmation' window is opened when a request 
is made to delete an: entry fromi the CONTROL-M Job Status screen, 
(screen 3). 


Y (Yes) 


N (No) 


A confirmation, window is displayed, 


The delete request is pllocessed without prompting the 
user for confirmation .. Default . 


Controls whether or not a confirmation· window is displayed when a 
request is made to delete arepol't in screen U o:f CONTROL-D. 


Y (Yes) 


N (No) 


A confirmation· window is displayed. 


The delete request is p11ocessed without prompting the 
user foll confirmation'. Default. 


Controls the method o:f exiting the Zoomi screen (screen 3.Z) of the 


CONTROL-M Online interface when the user has made changes. 


Y (Yes) 


N (No) 


The PF03/END command is interpreted as a SA VE 
request and a SA VE confirmation· window is displayed 
to pl'ompt the user foll confirmation. 
If an explicit SA VE command is issued in the command 
line, changes to1 the job entry is made without 
displaying the SAVE confirmation: window. 


An explicit SA VE command must be issued in the 
command line to request that changes be kept. No 
SAVE confirmation window is displayed .. Default. 


Controls whether or not a confirmation window is opened when a 
request is made to add a prerequisite condition from the CONTROL-M 


Why screen (screen 3;?). 


Y (Yes) 


N (No) 


A confirmation window is displayed~ Default. 


The add, request is processed without prompting the 
user for confirmation. 


Controls whether or not a confirmation window is displayed. when, a 
request is made to erase a condition from the IOA Manual Conditions 
list (screen 7). 


Y (Yes) 


N (No) 


A confirmation window is displayed. 


The erase request is p11ocessed without prompting the 
user for confirmation. Default. 


Controls whether or not a confirmation window is displayed when a 
request is made to delete a condition/resource from the IOA 


Conditions/Resources file (screen. 4). 


Y (Yes) 


N (No) 


A confirmation window is displayed. 


The delete request is processed without prompting the 
user fol' confirmation'. Default. 
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Color Variables 


A color and highlight value can be specified for each of the profile variables described 
below. Each profile variable has its own default color and highlight value. The format for 
specification of color and highlight is: 
profile-variable=color,highlight 


Where: 


profile-variable 


color 


highlight 


Name of the profile variable for which color and highlight values are 
being specified. Profile variables used to specify colol' for elements in 
the IOA environment are listed below. 


Color of the r levant element. Valid values are: 


BLUE 


RED 


PINK 


GREEN 


TURQ 


YELLOW 


WHITE 


Type of display fo11 the element. Valid values are: 


BLINK 


USCORE 


REVERSE 


The following profile variables are used to determine the color and highlight attributes of 
specific elements in the IOA environment: 


SMSGERR 


SMSGINF 


SMSGSVR 


SMSGWRN 


SOLVHFC 


Attribute for ERROR messages (whose codes end with E). 


Default: PINK,REVERSE. 


Attribute for INFORMATION messages (whose codes end with I). 


Default: TURQ,REVERSE. 


Attribute fo11 SEVERE error messages (whose codes end with S). 


Default: RED,REVERSE. 


Attribute for WARNING messages (whose codes end with W). 


Default: YELLOW,REVERSE. 


Attribute fo11 the header area in Online Viewing screens (screens U.V 
and.3.V). 


Default: PINK, REVERSE. 
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SLNFPAG 


SOLVOCL 


SOL.VSCI1 


SSYVSCL 


Attribute fo11 the sample lines when editing a report to create a ruler 
in the CONTROL.-D Online Viewing screen (screen U.E). 


Default: RED,REVERSE. 


Attribute for the overlay line in Online Viewing screens (screens U.V 


and 3V). 


Default: RED,REVERSE. 


Attribute for the scrollable a11ea in Online Viewing screens (screens U.V 


and3.V). 


Default: BLUE,REVERSE. 


Attribute for the SYSOBT viewed from screens U.V and 3.V. 


This parameter is effective only for sites with CONTROL-R installed'. 


Default:WHITE,REVERSE. 


Work Mode Variables 


PI'>ATELTH 


PSCHDTYP 


SSCHBRO 


SSYVORD 
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Date format length (does not affect all IOA date references). Valid 


values are: 


6 digits .. The format is ddmmlYY. Default. 


8 digits .. The format is ddmmyyyy. 


Note 
This variable effects only to Western date formats. 


Defines the default value of the date field in the confirmation window 
opened as a result of 011dering or fo11cing a job/rule/mission, from a 
Definition List screen (screens 2, R, M, OR, and BM). 


DATE 


ODAT 


Gregorian date corresponding to DATE (the MVS 


system date) is inserted: in the window. Default. 


Gregorian date co11responding to ODAT (the site 
working date) is inserted in the window. 


Controls whether or not a user is fo11ced into BROWSE mode when a 
schedule definition selected from any of the TOA definition screens is 
in use by another user. 


Y (Yes) 


N(No) 


Force the user into BROWSE mode. 


Display message CTM71 7E and reject the option. Default. 


Controls the 011der of jobs displayed under Option 3.V of the 


CONTROL-MIR Online interface (SYSOUT viewing). This parameter 
is relevant only for sites with CONTROI'..-R installed. 


FIFO 


LIFO 


SYSOUT is viewed in FIFO (first in, first out) 011der. 


The oldest job's SYSOUT is displayed first. Default. 


SYSOUT is viewed in: LIFO (last in) first out) order. 
The most recent job's SYSOUT is displayed first. 
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SINSLMT 


SUS2LMT 


SUS2SRTI 


SVEWFFl 


PZUMFAPP 


PZUMFGRP 
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Limits the lines to be read in the Media Database list (screen Tl'). 


The search limit is a number from 1 to 999,999. Default: 100,000. 


Limits the lines to be read in screen U. 


The search limit is a number from 1 to 999,999. Default: 500. 


A value 0£ 999999 specifies an unlimited search. 


Automatically activate the SORT command in, screen U. 


Valid values are: 


Y (Yes) 


N (No) 


Automatically activates the SORT command upon 
accessing screen U. 


The SORT command is not activated when accessing 
screen U. Default. 


See the CONTROL-D User Manual for more details about the SORT 


command in screen U. 


Used in online viewing screens U.V and 3.V to speed up the FIND 
command. 


N (No) 


Y (Yes) 


The regular FIND command is activated when viewing 
reports/sysouts. Default. 


Activates 
a 
fast 
find 
algorithm when 
viewing 
reports/sysouts. 


The line where the string is found is always displayed as the first line 
on, the screen, In CONTROL-D, the fast find algorithm applies when 
viewing reports without rulers. 


In: the Job Scheduling Definition screen (screen 2), controls whether 
or not the user is required to enter a value in the APPI'...ICATION 


field. 


Y (Yes) 


N (No) 


The user is required to enter a value in the 


APP!JICATION field. 


The user is not required to enter a value in the 


APPLICATION field. Default. 


In the Job Scheduling Definition screen, (screen 2), controls whether 
or not the user is required to enter a value in the GROUP field. 


Y (Yes) 


N (No) 


The user is required to enter a value in the GROUP 


field. 


The user is not required to enter a value in the GROUP 


field. Default. 
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lFLTSTA 


RESWPF3 


SRESDRNG 


SRCHLMT 


PNRSDTYP 


SNRSDRNG 
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Specified the name of an optional initial filter when entering the 


CONTROb-M Job Status screen (screen 3). If a valid filter name is 
specified, it becomes the default o:fthe initial SHOW filter of screen, 3. 


EXEC 


blank 


Filter EXEC is displayed as the initial SHOW filter, 
until the user changes it using the SHOW xxx 
command, regardless of the last filter that was used. 


No initial filter is used. The filter that was used' the 
last time screen 3 was entered is displayed. Otherwise, 
the default filter is used as the initial filter. Default. 


Specifies whether PF3 will be used in addition' to PF4 in the Show 


window of the Job Status screen (screen 3) to reset (i.e., exit the 
window with no action). Valid values are: 


Y (Yes) 


N (No) 


PF3'will reset the window. 


PF3 will not reset the window. Default. 


Determines date range fov the Conditions/Resources file (screen 


4).Valid.values are: 


ALL 


YEAR 


MONTH 


-nnn 
Sets FROM TO -nnn' days from today, and, UNTIL TO 


the current date. Default: -3~ 


Specifies the search limit for the IOA Log file and the Automation Log 
file (screens 5 and OA). This paz:ameter must contain six valid digits 
(including leading zeroes if necessary). Default: 10,000. 


Defines the default value of the date field in· the window opened as a 
result of adding a new manual condition1 (ADD NEW command) in, the 


IOA Manual Conditions file (screen 7). Valid· Values are: 


DATE 


ODAT 


Gregorian date corresponding to DATE (the MVS 


system date) is inserted in the window. Default. 


Gregorian1 date covresponding to ODAT (the IOA 


operating date) is inserted in the window. 


Determines the DATE range for the IOA Manual Conditions file 
(screen 7). Valid values are: 


ALL 


YEAR 


MONTH 


-nnn 
Sets FROM TO -nnn days from today, and UNTIL TO 


the current date. Default: -3~ 
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Presentation Mode Variables 


ISPFBOTL 


SBALTBO 


SRCMTBO 


SMISTBO 


SOMPTBO 


SREPTBO 


Controls the position of the last screen line when the IOA Online 
interface operates under ISPF. 


Ll 


L2 


The last IOA screen line is displayed on the bottom line 


of the physical screen. Default. 


The last IOA screen line is displayed on the second line 
from the bottom of the physical' screen. 


Controls whether a confirmation window 011 a double confirmation 
window is opened when an entire mission, is ordered or forced in the 


CONTROL-B Mission List screen (screen BM). 


N (No) 


Y (Yes) 


A confirmation window is opened when a mission is 
ordered or forced. Default. 


A double confirmation window is opened when a 
mission is ordered or forced. 


Controls whether a confirmation window 011 a double confirmation 
window is opened when a rule is ordered or forced in the CMEM Rule 
list (screen C). 


N (No) 


Y (Yes) 


A confirmation window is opened when a mission is 
ordered or forced. Default. 


A double confirmation window is opened when a 
mission is ordered or forced. 


Controls whether a confirmation window or a double confirmation 
window is opened when an enti:r~e mission is 011dered or forced in the 


CONTROL-D Printing/Backup/Restore Mission list (screen M). 


N (No) 


Y (Yes) 


A confirmation window is opened when a mission is 
ordered or forced. Default. 


A double confirmation. window is opened when a 
mission is ordered or forced. 


Controls whether a confirmation window or a double confirmation 
window is opened when an, entire table is ordered or fo:vced in the 


CONTROL-0 Rule Table list (screen OR). 


N (No) 


Y (Yes) 


A confirmation· window is opened when a table is 


o:vdered or forced. Default. 


A double confirmation. window is opened when a table 
is ordered or forced. 


Controls whether a confirmation window or a double confirmation 
window is opened when an entire mission is 011dered or forced in the 


CONTROL-D Mission list (screen R). 


N (No) 


Y (Yes) 


A confirmation window is opened when a job is ordered 


011 forced. Default. 


A double confirmation window is opened when a job is 
ordered or forced. 
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SRLDATO 


SUSRHDR 


SUSRFTR 


SUSRVEW 


SSCHTBO 


SSTALTO 
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Controls whether Rule Description' 011 Rule Data is displayed by 
default in the CONTROL-T Rule list (screen TR). 


N (No) 


Y (Yes) 


Display the Rule Data by default. 


Display the Rule Description by default. 


Controls the display type of the header of the User Report entry 


paneL Default: blank. When a blank is encountered, the following 
values will' be used: 


When CONTROL-Dis installed display type D. 


When CONTROL-Vis installed, display type V. 


Controls the display type ofithe footer of the User Report entry panel. Default: 
blank. When a blank is encountered, the follbwmg values will! be used: 


When CONTROL-Dis installed display type D. 


When CONTROL-V is installed display type V. 


Controls whether or not the view indicato11 in the Report List screen 
(screen, U) is displayed, and if it is displayed~ what the format is. 


N(No) 


Y (Yes) 


A 


The view indicator is not displayed and not saved. 


The view indicato11 is displayed. as a blank if the report has 
not yet been viewed, and as V if the report has been 
viewed. Default. 


The view indicator indicates the number ofi times (a 
maximum of 255) the repo:rit has been viewed.. If the 
number is too large to· fit into the display field, an asterisk 
(*) is displayed. 


Note 
By default, the view indicator is one column 
wide. 


Controls whether a confirmation window 011 a double confirmation 
window is opened when an entire table is orde11ed, or forced in the 


CONTROL-M Table list (screen 2). 


N (No) 


Y (Yes) 


A confirmation window is opened when a table is 


011dered or forced. Default. 


A double confirmation' window is opened when a table 
is 011dered 011 forced. 


Controls whether or not late jobs are combined with all other jobs in 
the Show Screen Filter window of the CC>NTROL-M Job Status screen 
(screen, 3). Valid values are: 


ONLY 


blank 


Late jobs are not combined with all other jobs (i.e., only 
late jobs are displayed, regardless of what other 
selection criteria are specified). Default. 


Late jobs a:rie combined with jobs that conform to other 
selection criteria, 
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Miscellaneous Variables 


I COLOR 


IDB CS 


TCOLOR 


Times 


USCORE 


Specifies whether o:v not extended color suppo:vt should be used fo:v 


terminals accessing the IOA Online facility from IMS, IDMS, and 
other systems that do· not allow determination of terminal 
characteristics. 


YES 


NO 


Use extended color support for this terminal. 


Do not use extended color support for this terminal. 
Default. 


Specifies whether or not Double Byte Character Set suppovt should be 
used for terminals accessing the IOA Online facility from IMS, IDMS, 
and other systems that do· not allow determination of terminal 
characteristics. 


YES 


NO 


Use Double Byte Character Set support for this 
terminal. 


Do not use Double Byte Character Set support for this 
terminal. Default. 


Specifies whether or not extended color support should be used for 
terminals accessing the IOA Online facility from TSO or ROSCOE. 


TERMINAL 


YES 


NO 


Query the hardware to determine whether or not to 
use extended color support for this terminal. Default. 


Use extended colo:v support for this terminal. 


Do not use extended color support for this terminal. 


Specifies whether or not Double Byte Character Set support should be 
used fo:r terminals accessing the TOA Online facility from TSO or 


ROSCOE. 


TERMINAL 


YES 


NO 


Query the ha:vdware to, determine whether or not to 
use Double Byte Character Set suppo:vt for this 
terminal. Default. 


Use Double Byte Character Set support for this 
terminal. 


Do not use Double Byte Character Set support for this 
terminal. 


Controls whether or the UNDERSCORE attribute fo:v fields should be 
suppressed or honored. Some terminals and terminal emulator 
programs may display underscored fields with inco:vrect colors and/or 
reverse video. 


YES 


NO 


Honov the UNDERSCORE attribute for terminal 
fields. 


Suppvess the UNDERSCORE attribute for terminal 
fields. Default. 
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EDIMACNM 
Name of the optional' !SPF EDIT !MACRO to be used when editing of 


ajob's JCI:.. ini screens 2:J and 3:J. 


macro name 


blank 


The specified !MACRO is invoked at entry to 


!SPF EDIT. 


No !MACRO is invoked at entry to !SPF EDIT. 
Default. 


Other Types of Profile Variables 


TERMTYPE 
Specifies the terminal' type used: to access the IOA Online 


environment. Valid value is: 


3270 
IBM 3270 011 3270 Emulation terminal. Default value 
for MVS users. 


Modifying IOA Product Defaults 


After one or more CONTROL p11oducts are installed and running for a period' of time, 
certain defaults can be modified within the p11oduct. For example, increase the number 0£ 
CONTROL-M attempts to read ajob1s sysout. 


l. Review the documentation: member IOADFLTS, explaining the defaults which can' be 
modified fo11 IOA. This member resides in the IOA SECNDATA lib11ary. 


2. Update member IOADFLTC in the IOA MAC lib11ary using member UMIDFLTU in the 


SECUDATA library. Modify one or move default values as detailed in the 
documentation: member xxxDFLTS (where xxx is a product code). For the above 
example, you can modify the default value of APPLY to YES (turn, off uppercase). Note 
that the parameters are in: Assemble!' Macro format, and are therefo11e restricted to 
Assembler Macro syntax (continuation, mal'ker in column, 72, continuation line stal'ts at 
column 16, etc.). 


Note 
Line number columns 73-80 must remain the same as in IOADFLTC in the JOA 


MAC library; 


3~ In addition to member IOADFLTC, there may be user exits in the IOA SECVDATA 
libnary which can be applied to modify default pnocessing within: a specific product. See 


member $DOISECU in the IOA SECUDATA libnary fon more infonmation. 


Note 
Once all the required changes are made to the CONTROL product defaults, it is 
necessary to restart all the monitors and users of the modified products by 
shutting down the monitors and restarting them, and logging users off and on. 
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Modifying IOA Messages 


IOA messages can be adapted for local languages, site-specific terminology, etc. 


IOA messages are stored in the IOA MSG library. The messages are organized in members 


with the following naming conventiom 


CTxAMyyy 


CTxMyyy 


CTxRMyyy 


CTxTMyyy 


CTxCMyyy 


Where 


x 


yyy 


A single character indicating the product (e.g., M for a CONTROL-M 


screen) .. 


A 3-character message member identifier. 


Each member contains definitions for one or more messages. The definitions are specified 
as Assembler macro instructions. Each member must be assembled and link-edited to 
create a CSECT and module with a name identical to the message member name .. The load 
module containing the messages replaces an existing CSECT in one or more load modules 
in the IOA LOAD library. 


The message member must contain a CTMLEVEL macro prior to the first message 
definition. If this macro is omitted) results can' be unpredictable. 


Each message is defined by macro CTMMMSG. This macro has the following parameters: 


CODE 


MESSAGE 


PARM 


Code of the message. Do not change this code, since it is used to 
connect the message to the application pi;ogram~ 


Text of the message (in quotes). 


Length and position of the text inserted into the message by the IOA 


application. The format of this parameter is: 


PARM= (posl,lengthl,) 


pos is the position of the inserted text in the message +6~ 


length is the length of the text to be inserted. Do not change this 
length. 


Parameter PARM is optional, but must be used whenever it already appears in the 
message definition. When the contents of a message are modified) the position of the 
application generated area in, the message may change, so the PARM field must be 
modified accordingly. The order of the fields in the PARM should not be changed, but it is 
possible to change the order of appearance in the message by changing the positions. 
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Example 


The original message (from member CTMMSEL): 


C'l'MMMSG CODE=SEL2 0 6W., PARM= ( 18 •, 5 I 2 9 I 16} I 


MESSAGE ='ABENDED CC XXXXX S'l'EP· YYYYYYYY'YYYYYYYY' 


The modified message: 


C'l'MMMSG CODE=SEL2 0 6W., PARM= ( 4 5 I 5 I 2 3 I 16) I 


MESSAGE='ABENDED ON S'l'EP YYYYYYYYYYYYYYYY CODE XXXXX' 


Recommended Steps for Message Modification 


Sources (message members) ofi IOA pl'oducts are modified• via an SMP/E USERMOD. Use 


the following steps to perform this task: 


1. Choose a name for the USERMOD (to be built in the following steps). The name of the 


USERMOD must be 7 characters in• length, must begin with an alphabetic character 
(i.e., not a number or symbol~, and must be unique. 


2. Create a new member in the IOA MAINTLIB library with the same name as the 


USERMOD created in Step L 


3, Copy the contents of member UMODSRC in the IOA JCL library to the newly-created 
member. This member contains a skeleton sample fo11 the USERMOD (to be customized 
in the following steps). 


4. Specify the name of the new USERMOD in the ++ USERMOD statement. 


5. Determine the FMID and the RMID of the message source via SMP/E Option 3.2~ 


Specify SRC as the entry-type and the name of the message sou!lce as the entry-name. 


Specify the FMID in the ++VER statement. 


If the RMID value is not the same as the FMID value, add the RMID value to the 


++VER statement via the PRE(rmid~value) parameter. 


6. Specify the source-name in the ++SRC statement. 


7. Copy the contents ofi the source member to the line immediately after the ++SRC 


statement .. Update the copy to meet your needs. 


8. Specify the name of the USERMOD in job UMODRACK in the IOA JCL library. Run' the 


job; This job RECEIVEs and APPLY-CHECKs the USERMOD. 


Job UMOBRACK must end with a completion code of 0. 


9. Specify the name of the USERMOD in job UMODAPP in the IOA JCL library. Run1 the 


job; This job applies the USERMOD. 


Job UMODAPP must end with a completion code ofi O, 
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IOA Dynamic Destination Table 


One of the IOA facilities is the Shout facility. It allows the user to specify messages to be 
sent to specified destinations upon the occurrence of various events. 


Destinations in a p:rioduction environment are not necessarily fixed. Fo:ri example, the TSO 


logon ID of the shift manager may be different for every shift. The Dynamic Destination 
table allbws the user to specify a logical destination name fo:ri a group of destinations. 
When the logical destination name is specified as the destination of a Shouted message, 
the message is sent to each destinationi in' the group. 


An example of such a table can be found in the member IOADEST in the IOA INSTALL 
library. To update the Destinationi table, you must assemble and link-edit load module 


CTMDEST using member IOADESTJ in the IOA INSTALL library, and subsequently 
reload the table into memory fo11 each of the IOA p11oducts installed at your site. For more 


info11mation regarding Dynamic Destination tables, see "IOA Dynamic Destination Table" 
in Section 1 of this guide. 


Replacing the Current Dynamic Destination Table 


The Dynamic Destination table is loaded wheni the IOA product monitor is started. To 
replace the current Destination table with a new one, use the app:riop:riiate operator 
command fo11 each IOA product installed at your site. 


F CONTROLM, NEWDEST (fo11 CONTROL-M.) 


F CONTROLD, NEWDEST (fo11 CONTROL-D) 


F CONTROLO,NEWDEST (fo11 CONTROL-0) 


F IOAFMON, NEWDEST 
(fo11 the I OA Functional monitor used, by CONTRO L-T) 


After a few seconds, a message regarding the result of the operation is displayed on the 
operator console from which the modify command was issued. 


Example 


The following are sample lines from a Dynamic Destination table: 


CTMGDEST TSO-SHIFT-MNGR,DEST=(TSO-Q04,0PER,U-Q04) 


CTMGDEST TSO-DBA,DEST=(TSO-S08,TSO-S09) 


Expanding the Resource File (RES) 


1. Close all the monitors and IOA activities. 


2. Rename the old RES and SNC files to a different name. 


3. Select major step "Customize Dataset Parameters'' from the CUSTOMIZE activity in 


ICE. Change the value of parameters RESREC# and RESLREC to the required values 
(A maximum of 32 fo:ri parameter RESREC#, and a maximum of 32760 fo11 parameter 


RESLREC). Complete the remainder of the minor steps for this step to update and 
compile member IOAPARM, and customize the formatting jobs. 
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4. Edit member FORMRES in the IOA INSTALL library. Check that the value of 
parameter LRECL is identical to the value ofi parameter RESLREC ini member 


IOAPARM, and that the value ofi parameter RECNUM is calculated as follows: 


RESREC#*32+2 .. Submit this job, This job will allocate and format a new set of 


RES/SNC files with the new size. 


5. If you do not use a dual resource file, skip to step 8 below. 


6~ Edit member FORMDRES in the IOA INSTALL.. lib11ary. Check that the value of 
parameter LRECL is identical to the value of RESLREC in IOAP ARM, and that 
parameter RECNUM is calculated as follows: RESREC#*32+2. Submit this job. This job 
will allocate and format a new set ofi ALTRES/ALTSNC files with the new size. 


7. Copy the old resource file into the new one using utility IOACOPRS. 


8. Start the monitors. 


Expanding the IOA LOG File (LOG) 


1. Close all the monitovs and IOA activities .. 


2~ Rename the old LOG file to have a different name 


3. Select major step "Customize Dataset Parameters" from the CUSTOMIZE optioni in 
ICE. Recalculate the LOGSlZE parameter. Complete the remainder ofi the minor steps 
in this step to update and, compile member IOAPARM, and customize the formatting 
jobs. 


4. Submit member FORMLOG in the IOA INSTALL.. library. This job allocates and fo11mats 


a new LOG file with the new size. 


5. Copy the old LOG file into the new file using job IOACPLOG in' the IOA JCL lib11ary. 


6. Start the monitovs .. 
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General 


This section, describes the initialization, customization, and administration features that 
are available fo11 CONTROL-M. 


Activating the CONTROL-M Monitor 


The CONTROL-M monitor usually ope:r:ates 24 hours a day as a started task (STC). 
Usually the monitor is automatically activated as part 0:£ the IPL p:vocess. To activate the 


monito:v manually, use the operator command: 


S CON'l'ROLM 


If the monito:v is successfully activated, the following message appears on, the operator 
console: 


C'l'MlOO~ CON'l'ROL-M MON~TOR STARTED 


Once the CONTROL.-M monito:v is active, if you try to activate an: additional CONTROL-M 
monito:v with the same IOA components in the same computer, the new (i.e., additional) 
monitor immediately shuts down and an: approp:viate message is issued. 


Note 
It is possible to activate more than one CONTROL-M monitor in the same computer 
environment (e.g,,. PROD and TEST version) by defining a different IOA environment 
(and a different QNAME) for each monitor. See "Installation Considerations" in the 


CONTROE-M installation procedure in the IOA Installation Guide; 


Shutting Down the CONTROL-M Monitor 


If fo11 some reason it is necessary to: shut down the CONTROL-M monitor, use the operato:v 


command: 


P CON'l'ROLM 


After a few seconds (a maximum of a minute), the CONTROL-M monitor shuts down and 
the following messages appear on the operator console: 


C'l'M107~ SHUT DOWN UPON REQUEST FROM OPERATOR 


C'l'M120~ CON'l'ROL-M MON~'l'OR SHUT'l'~NG DOWN 


(not highlighted) 
(highlighted, unrollable) 


fo, case of emergency, the CONTROL-M monitor can be canceled~ However, this is not 
recommended. If the monitor is canceled, repo:vts p:voduced from: the IOA Log file may not 
be complete. 


Note 
When you shut down the CONTROL-M monitor, all other CONTROL-M facilities (e.g.,. 
CMEMJ, IOA Online monitors, and Online facility sessions can remain active. 
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Modifying the CONTROL-M Sleeping Interval 


Periodically, at a p11edefined interval~ CONTROL-M "wakes up~ and checks what it has to 
do. This interval is set via a CONTROL-M installation parameter and can, be changed by 
the system administrator. In addition1 the interval, can be altered by the operato11 


command: 


F CONTROLM,:CNTERVAL=:xx 


where xx rep11esents the interval in seconds .. 


It is recommended that the interval be modified by automatic commands invoked by the 


CONTROL-M monitor itself according to set conditions and time ranges, and, not manually 
by the operator. 


At most sites, the interval should be longer during the day (when, fewer batch p11oduction 
jobs are executing) and sho11ter during the night. 


The optimal, sleeping interval depends on, the p11ocessing power 0£ the machine. Depending 
on the p11ocessing power of the machine indicated below, the sleeping interval should 
usually not be less than, the number 0£ seconds indicated: 


• Fo11 machines with less than' 20 MIPS 
10 seconds 


• For machines with 20.:.50.MIPS 
5-6. seconds 


• Fo11 machines with over 50·MIPS 
4 seconds 


There is no p11actical benefit in1 setting the interval to less than, these minimums .. Doing so 
could slow down, CONTROL-M operation. 


When the modification1 is received, by CONTROL-M, the following message is displayed on, 
the operator console from which the modify command, was issued: 


C'rM123:C CONTROL-M :CNTERVAL :CS SET TO nn SECONDS 


Starting the CONTROL-M EVENT MANAGER (CMEM) 
Facility 


The CONTROL-M Event manager (CMEM) is designed to handle events occurring outside 
the controli of the CONTROL-M monito11. CMEM consists of a monito11 which uses the IOA 


subsystem and perfo11ms p11edefined actions in response to system events (e.g., arrival1 of a 
specifiedjob on' the JES spool). 


Note 
When CONTROL-0 is installed at your site, the CONTROL-0 moniton takes over 
control of the CMEM facility. In this case, this description of the CMEM facility is not 
relevant for your site. Instead,. refer to· Section 5 in this guide for information on how to. 


manage the CMEM facility at your site. 
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The CMEM monito11 must ope11ate 24 hours a day. The usual way to. ensure this is to 
automatically initialize the CMEM monitor during the IPL p11ocess. 


To start CMEM as part of the IPI'.., add the following command to member COMMNDnn' in 


libra11y SYSl.PARMLIB (where nn is either the number specified in member IEASYS in 


library SYSl.PARMLIB, or defaults to 00 if not specified: in IEASYS): 


S CTMCMEM 


The same operator command, can: be used, to activate the CMEM monitor manually. 


Shutting Down the CMEM Facility 


Under normal circumstances, the CMEM monitor is not shut down 
1 •• However, CMEM 


shutdown might be necessary for the following reasons. 


• To resolve a pimblem that cannot otherwise be resolved. In this case, the monitor should be 
immediately restarted after the problem is solved to minimize the impact of the shutdown 
on the work envi11onment. 


• To clean: up (erase) all loaded CMEM tables fromr memo:cy, or stop all CMEM functionality 
(e.g., for a system shutdown). 


To stop. and immediately restart the CMEM facility, replace the active CMEM monitor by 
starting a new CMEM monitor. (See "Replacing an Active CMEM Monitor" below.) 


When the monitor replacement method is not applicable, and a complete shutdown is 
required, issue one of the following operato11 commands: 


F CTMCMEM,STOP 


or 


P·CTMCMEM 


CMEM shuts down after a few minutes. 


Note 
CMEM rules are not triggered for dataset events and step; termination events caused by 
jobs·that start while CMEM is down. 


Replacing an Active CMEM Monitor 
If a CMEM monitor is currently active, and a new CMEM monitor is started (via operator 
command S CTMCMEM), the current CMEM monitor passes execution control to the new 


CMEM monitor and then shuts down. It is not necessary to reload the rule tables. They 
are passed from the current monitor to the new one. Therefore, to stop and immediately 
restart the CMEM monitor with minimum: interference to on~going work, issue the 
following operator command: 


S CTMCMEM 
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Job Ordering via New Day Processing 


Overview 


The CONTROL-M monitor is usually activated as a started, task and remains active 24 
hours a day. At a set time each day (defined. via installation pa11amete11s), New Day 


pvocessing is performed by the CONTROI:.-M monitor. 


New Day processing consists of both automatic cleanup from the pvevious day's job 


ordering and automatic 011dering of jobs for the new day. 


The main• components related to New Day processing are: 


• Schedulingtables andjob•scheduling definitions 


• New Day procedure and User Daily jobs 


• Date Control records 


• Active Jobs file 


New Day processing is completely automated• through the use of the New Day pvocedure1 


and• User Daily jobs .. The main purpose of the New Day pvoceduve and User Daily jobs is to 


call p11ograms that: 


• Scan scheduling tables to·selectjobs for scheduling. 


• Schedule the selectedjobs (i.e., place copies of the selected· job scheduling definitions as job 
orders in the Active Jobs file). 


The New Day p11ocedure and each· U se11 Daily job· must have its own Date Control reco11d. A 
Date Control record is a member in• the CONTROL-M PARM library in which relevant date 
information is placed during New Day p11ocessing. This date infovmation is used to manage 
job orders. 


Selection of jobs is based on the Date Control record, the current date, and the Basic 
Scheduling parameters 0£ the jobs in the scheduling tables. Any time the User Daily job is 


run, the current working date is placed in the Date Control record. The Basic Scheduling 


pa11ameters of each, job in· the scheduling table a11e checked against this date to see if the 
job should be placed inthe Active Jobs file. 


1 Called the "General Daily" prior to IOA Release 5.0.0 
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New Day Procedure 
i-------t...--------i>,4----lll'late Control Records 
User Daily Jobs 


Scheduling· 
Tables 


Job Schedl.lling 


Definitions 


New Day processing generally works as follows: 


Active Jobs File 


I Job 11 
1Job2I 
lJob3I 
~ 


• The New Day procedure is perfo:ro:ned each day at its predefined time. It: 


- 
Schedules User Daily jobs. 


- 
Schedules maintenance jobs. These jobs call' programs which perfo:ro:n' cleanup after the 
previous day's processing. 


• User Daily jobs (scheduled by the New Day p11ocedure) select and schedule aU other jobs fo:ri 


that day. 


New Day 
Procedure 


Job Orders 


Active Jobs File 


User Daily 1 


User Daily 2 


Maintenance Jobs 


Job Order 


Job Order 


Job Order 


Sample New Day Processing 


User 
Daily1 


CONTROL-Mis supplied with samples of seve11al of the above mentioned components. 


To effectively implement New Day processing at your site, you must first understand how 
the sample components operate. Once the operation, of the sample components is 
understood, you can then' customize New Day processing based on site requirements. 


Sample New Day processing components are described below. 
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Sample Components.Provided With CONTROL-M 


At time ot installation, each site is provided with the following: 


• New Day Procedure 


A single New Day pllocedure is p11ovided~ Its default name is CONTDAY (the name can 
be changed). This pllocedure should have wide authorization for accessing scheduling 
tables andjobs. 


• User Daily Jobs 


The following sample User Daily jobs a11e provided,; 


DAILYPRD 


DAILYSYS 


Contains sample JCL for schedulingproductionjobs. 


Contains sample JCL for scheduling system1jobs. 


These sample User Daily jobs are defined in, table MAINDAY in1 the SCHEDULE 
Lib11ary. These jobs activate User Daily procedure CTMDAILY which is responsible foll 


ordering the p:r:oduction1jobs. 


It is gene:r:ally advisable to use these sample User Daily jobs to create sepa:r:ate User 


Daily jobs acco:r:ding to department (or othell functional entity) and acco:r:ding to 
authorization. This is described later in this section. 


• Maintenance Jobs 


The following maintenance jobs are p:r:ovided: 


CTMCLRES 


CTMLDNRS 


Activates utility IOACLRES which cleans the IOA Conditions/Resources 
file. 


Activates utility IOALDNRS which creates and loads the Manual 
Conditions file. (This utility is nollmally run after all1 User Daily jobs have 
executed.) 


These maintenance jobs are defined in table MAINDAY in1 the SCHEDULE libllary. Utilities 
IOALDNRS and IOACLRES a11e described in Section 9 of this guide. 


• Scheduling Table:· MAINDAY 


A scheduling table called MAINDAY is pllovided in the SCHEDULE library. This table 
contains the above mentioned User Daily jobs (DAILYSYS and DAILYPRD) and' the above 
mentioned maintenance jobs (CTMCLRES and: CTMLDNRS). 


• Date Control Recollds 


The following Date Control recollds (members) are supplied in the CONTROL-M PARM 


library: 


DATEREC 


DATERECU 
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Defined for New Day procedulle CONTDAY. 


Sample Date Control record for User Daily jobs. 


IOA Rel~ 5.0.0 Administrator Guide 


' 
\ 
v 


i 
) 
"-' 


( 
i 
\_,,' 


Section 3: Customizing and Administering CONTROL-M 


• Called Programs 


The New Day pvocedme and User Daily jobs call 
1 programs which perfovm various steps of 
New Day processing (checking the Date Control1 recovd, selecting job orders, etc.). These 


pvograms ar:e described in: "Programs Called During New Day Processing" later in this 


section, 


How the Sample Components Perform New Day Processing 


New Day pvocessing perfovmed with the sample components works as follows: 


During New Day pvocessing, the New Day procedure accesses its Date Control recovd, 


scans table MAINDAY, and selects and loads the maintenance jobs and User Daily jobs to 
the Active Jobs file .. 


Scheduling 
New Day 
Date Control 
:-------+ Procedure +-- 
Record: 
~ 
Library(ies~ 
(CONTDAY) 
(IJ>ATEREC) 


Table MAINDAY 


~ 


User Daily Job #1 
I 
User Daily Job #2 
I 
User Dail~ Job #3 · 
I ,_ 


MAINT JOB CTMLDNRSI 
Active Jobs File 


MAINT JOB CTMCLRES 
I 
• 
User Daily Job #1 
Table A 


Table B 
I User Daily Job #2 


TableC 
I 
Table D 
User Daily Job #3 


~ 
etc. ~ 
I 
MAINT JOB CTMLDNRS 
I MAINT JOB CTMCLRES 


The User Daily and maintenance jobs placed in the Active Jobs file are submitted by 


CONTROL-M according to their runtime scheduling criteria. When a User Daily job is 
executed;, it accesses its own Date Control record, scans the scheduling tables defined to it, 
selects jobs, and places the selectedjob orders in the Active Jobs file. (User Daily jobs can 
also schedule mafo.tenance jobs as required.) 
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1veos1e 
I Date Control 


Record #1 
User Daily Job #1 
Scheduling' 
-f-=l 
I'-_ Library(ies}_/ 
I Date Control. ; 
f....:j 
User Daily Job #2 
!Table MAINDAYI 
Record,#2 
-- 


Acf 
J b Fl 


Table A 
I Date Control 
I 
User Daily Job #3 
I 
- - Job-A1, Job·A2, 
Record#3 
Jot>.A3, etc. 


MAINT JOB CTMLDNRS f-- 
Table 8 


MAINT JOB CTMCLRES ~ 
- 
- Job-81, Job·B2, 
Job-83; etc. 


I 
Jot>.A1 
I 
Table C 


~~1 


Job·C1, Job-C2, 


Jot>.A2 
I 
Job·C3, etc; 


Table D 
I 
Job·A3 
I 
Job-01, Job·D2, 
Job•D3, etc. 


(No Jobs scheduled from 1 
"-..__ 
7 
- 
f.+ 
Table 8. No Basic 


Scheduling. Criteria 
satisfied) 


I Manual Conditions 
I 
Job .. C1 
I 
~I 
ust 


I 
Job·C2 
I 
I IOA Conditions/ 


I 
I Resources File 
Job-01 
I 


It should be noted that because User Dailies are jobs, their use is not restricted to New 
Day processing. Although User Daily jobs are normally executed immediately after they 
are ordered by the New Day procedure, they can be executed at any time defined' in theill 


Runtime Scheduling parameters. Furthermore, they can be ordered at any time by any of 
the methods described in "Alternative Methods of Job, Ordering~ in Section 6 of the 


CONTROL-M User ManuaL 


Date Control Records and Enhanced Daily Checkpointing 


A Date Control reco11d, must be defined fo11 each User Daily job. This record is usually 
defined by the IOA administrator. 


The Date Control, reco11d for User Daily jobs consists of six fields. At different stages in 
New Day p11ocessing (i.e., before or after the execution' of specific called programs which 


perform New Day p11ocessing), the current original scheduling date is placed in one of 


these date fields. 


This enables CONTROL-M to manage the p11ocess of job 011dering~ Furthermore, if New 
Day p11ocessing is interrupted at any point, the values in these fields can indicate which 


called, p11ogrami was in use when the interruption occurred. 


If the interruption occurred during job ordering, it is also' desirable to identify the last job 
or:dered so that ordering can, continue from that point. An optional second reco11d in1 the 
Date Control, member, the Enhanced Daily Checkpoint record, enables this identification. 
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The Enhanced Daily Checkpoint record contains fields which' store information about the 
last orderedjob: JCL member name, internal sequence number, order ID, and' the group to 
which the job belongs: 


• If Enhanced Daily Checkpointing is implemented> this information· "pinpoints" (identifies) 


from where job ordering left off~ andjob ordering continues from that point during recovery. 


• If Enhanced Daily Checkpointing is not implemented, when the User Daily is rerun, all jobs 
in the scheduling table are considered for scheduling (including those jobs already scheduled 
by the interrupted run). 


Both the Date Control1 reco11d and the Enhanced Daily Checkpoint record have a fixed 
format, discussed later in "I:mplementing New Day Processing~" 


Note 
If input scheduling tables are modifiedpnior to rerunning User Dailyjobs (or the New 
Day procedure), the checkpointed job. and internal sequence number might not match. 
In this case, rerun of the User Daily job(s) is terminated and manual intervention is 
required. 


Implementing New Day Processing 


As indicated1 earlier, sample User Daily jobs (DAILYSYS and DAILYPRD) are supplied 
with CONTROL-Min scheduling table MAINDAY. 


In theory, it is not necessary to use User Daily jobs .. It is possible (but not recommended) 
to place all job scheduling definitions in one or more tables and have them scheduled by 
the New Day procedure. 


It is also possible (and. also not recommended) to maintain only the two sample User Daily 
jobs provided with CONTROL-M, and to 011der all user jobs through the User Daily 


DAILYPRD. 


The recommended way of automating the production environment via New Day Processing 
is by: 


• Defining a different scheduling table for each group of relatedjobs. 


• Defining a different User Daily job for each department, application, or comparable entity. 


Such implementation provides the following advantages: 


Imp11oved performance 


Ease of administration 


Increased security 


Many User Daily jobs running in1 parallel can order the full' day's 
production jobs in significantly less time than it would 
1 take one 
User Daily to order alljobs one at a time. 


The IOA administrator can make each department responsible 
for its own User Daily job(s) and scheduling table(s) and for 


controlling its own job ordering. 


While maintaining exclusive authorization for the New Day 
procedure, the IOA administrator can limit each department's 
authorization to its own, User Daily jobs. 
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Minimization: of problems 
Problems encountered in one User Daily do not necessarily 
affect the job, ordering of other User Daily jobs. 


It is recommended that the following tasks (described. below) be performed when 
implementing New Day processing: 


• Decide which User Daily jobs are needed (and for which tables). 


• Customize the sample New Day procedure (CONTDAY). 


• Use the sample JCL to create JCL for each User Daily job:. 


• Create User Daily job, scheduling definitions and: customize table MAINDAY. 


• Decide whether or not Enhanced Daily Checkpointing wiU be used. 


• Create Date Control: records. 


Note 
The New Day procedure and its accompanying Date Control record are defined at 
time of installation, They require no further implementation. 


• Ensure subsequent runs of utility IOALDNRS if necessary. 


Implementation Tasks 


Decide Which User Daily Jobs Are Needed (and for Which Tables) 


A job scheduling definition: is defined: for each jobj and each: job 1 scheduling definition: is 
placed within a scheduling table. Usually, related job scheduling definitions are grouped 
into their own, scheduling table .. 


Based on the scheduling tables defined, at your site, and: the jobs they contain, decide what 


User Daily jobs you require, and which scheduling tables each User Daily job· will scan. 


Customize the Sample New Day Procedure (CONTDAY) 


Prerequisite conditions are always assigned a date reference (day and month). If old 
prerequisite conditions are not deleted from: the IOA Conditions/Resources file, after a year jobs 
can be incorrectly triggered by the old prerequisite conditions with the same date reference .. To 
prevent this problem) program: CTMFRM is activated: as part ofi the New Day procedure to 
erase all prerequisite conditions of the 
coming execution, date 
from 
the IOA 
Conditions/Resouttces file. 


IGNORE/SELECT Statements 


Often, prerequisite conditions which are not date-related (e.g., IMS-IS-UP, AR-FILE-OK). 


must not be erased. A list 0£ conditions which are not to be erased can be supplied via DD 
statement DAFRMIN. AutoEdit statements can be used as input to DAFRMIN. For more 


information, see the description, ofi utility CTMCAJF in Section 9 of this guide. 
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DD statement DAFRMIN is used to specify IGNORE and SELECT statements, which 
impact as follows: 


• Jobs meeting SELECT criteria are deleted. 


• Jobs meeting IGNORE criteria are bypassed (not deleted). 


The valid format is: 


{ 


COND 
GROUP 
:CGNORE I SELEC'l' 
JOBNAME 
S'l'A'l'US 


cond - prefix 
l 


GROUP· groupname 


JOBNAME jobnamel MEMBER membername 


S'l'A'l'US status [FROM date] ['l'O date] 


Note 
Conditions that are not date-related can also be defined with a date reference of STAT 
which eliminates the need for including IGNORE I SELECT statements in procedure 


CONTDAY. 


A maximum of 500 IGNORE/SELECT statements can be supplied. Jobs are handled 
according to· the first statement foJ.1 which criteria ave met. 


IGNORE/SELECT statements can come befoJ.1e OJ.1 after IGNORE COND but should not be 
mixed with IGNORE COND. 


AU conditions beginning with the pI1efi.x (cond-pI1efix) specified in an IGNORE COND 


statement will not be erased. 


Example 


To suppI1ess the erasure of the next day's conditions by the New Day pvocedure, specify 
one definition: 


:CGNORE COND * 


When suppI1essing the function, remember to delete conditions (via utility CTMCLRES). If 
this is not done, jobs in the next year's schedule will be triggered because of today's 
conditions. 


Parameters 


One or moJ.1e 0£ the following parameters can be specified in any IGNORE/SELECT 


statement (in any oJ.1der): 


GROBP groupname 


JOBNAME jobname/ 
MEMBER membername 


Name 0£ the group appearing in the job scheduling definition. 


jobname is the job name appearing in both the job statement 
and the J©B NAME field of the Status screen. membername is 
the Job· Scheduling Definition: name (name of the JCL file). Job 
name OJ.1 membername (but not both) can be specified in one 
statement. 


Note 
A group name, job name or member name prefix may be 
indicated by an asterisk(*) at the end of the name (e.g., 


PROD*). 
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STATUS status 
Specify one o:fthe followingjob statuses: 
END OK 
ENDNOTOK 


HELD 


WAITSCHEE> 
FROM date 


TO date 
Original' scheduling date ( ODATE) in yymmdd format. 
Original scheduling date ( ODATE) in yymmdd format. 


Example 


IGNORE JOB NAME OPER* 


IGNORE JOB· NAME PROD* S'l'A'l'tJS ENDNOTOK 


SELEC'l' GROUP 
'l'ES'l' 


In this example, no jobs whose names begin with prefix OPER are deleted. Also no jobs 
whose names begin with prefil.X PROD that ended NOTOK are deleted. Of the remaining 
jobs, those belongingto·groupTEST are deleted. 


Use the Sample JCL to Create JCL for Each User Daily Job 


Create the JCL for each User Daily job·by customizing the sample JCL shown below:· 


//DAILY 
EXEC 
C'l'MDAILY 


//DACHK 
DD 
DJ:SP=SBR,DSN=parm_lib(date_control_recoX'd) 


//DAJC:>B 
DD 
DISP=SBR1DSN=sched_library(table1) 
II 
DD 
DISP=SBR:,.DSN=sched_library(table2) 
II 
DD 
DISP=SBR:,.DSN=sched_libX'ary(table3) 
II 
DD 
DISP=SBR,DSN=parm_library(membeX') 


The above sample allows two alternative methods o:f identifying scheduling tables to the 
User Daily jobs. The user can1 choose either or both methods: 


• Normal Method 
DSN =sched;Jib11ary(table) 


This method requires that the user specify the name of a scheduling table and lib11ary 


directly in the JCL. 


• Alternative Method 
DSN=parm;.Jibrary(member) 


This method requil1es that the user specify a PARM lib11ary and member. The specified 
member contains 011der requests which identify scheduling librallies, scheduling tables and: 


jobs to·schedule. 


When using this method, the format of the reco11ds placed in, specified member o:f the PARM 
libraey is: 


ORDER {DSN=sched~library I DDNAME=ddname},MEMBER=table 


[,JOB=jobname] [,ODA'l'E=date] [,FORCE] 


Where: 


DSN=sched:Jibrary 
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Name o:f the scheduling libraey. Either this parameter or 
parameter DDNAME, but not both, must be specified. 
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DDNAME=ddname 


MEMBER=table 


JOB=Uobname · I *} 


ODATE=date 


FORCE 
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Pre-allocated DB name which points to the scheduling library. 
Either this parameter or parameter DSN, but not both, must be 
specified. 


Name 0£ the scheduling table which contains the job scheduling 
definitions. Mandatory. 


Name of a job scheduling definition' in1 the scheduling table. 


Optional' If a job name is not specified, or if an asterisk (*) is 
specified, the entire table is processed. 


Order date of the job(s) in the table (in mmddyy, ddmmyy, or 


yymmdd fomnat, depending on the site standard). This 
parameter overrides the checkpoint date (specified in DD 


statement DACHK). Optional. The default is the date from the 
checkpoint reco11d.· 


Places the job(s) 011der in the Active Jobs file regardless of the 
job's Basic·Scheduling pwameters. Optional• 


This method p11ovides the foll1>wing advantages over the nomnal methodc 


1. Individualjobs can be specified. 


2. Changes required can be made to the member in the PARM library without changing the 


JCL of the User Daily job: 


Note that the Date Control record is referenced by DD statement DACHK. 


Create User Daily Job Scheduling Definitions and Customize Table MAINDAY 


The supplied sample User Daily jobs, DAILYPRD and DAILYSYS, scan the scheduling 
tables referenced by DD statement DAJOB. However, different authorization is granted to 


each of these User Daily jobs. 


Use these sample User Daily jobs to create a User Daily job1 for each department in' table 
MAINDAY. Assign the autho11izations accordingly. Each User Daily job should scan a 
different set of scheduling tables than the other User Daily jobs. 


It is common, in many sites for the IOA administrator to create a customized User Daily 
job fo11 each department and then, turn' the scheduling table over to the control, of the 
department. The department can then modify the scheduling table (and job scheduling 
definitions) as necessary. 


Although: User Daily jobs can execute immediately after the jobs have been placed in the 
Active Jobs file, a site may choose to delay execution of a User Daily. To delay submission 
ofi a User Daily job, the User Daily's runtime scheduling criteria should be defined 
accordingly. 


Note 
If User Daily jobs are executed at different times, IOALDNRS should be run after each 
User Dailyjob.is run. 


Additional maintenance jobs can be added to table MAINDAY as necessary. 
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Decide Whether or Not Enhanced Daily Checkpointing Will Be Used 


Enhanced Daily Checkpointing enables automatic rerun of the job ordering process to 
resume from the unsuccessfully ordered job if New Day pr:ocessing terminates during job 
ordering (due to system crash, etc;). 


The decision 0£ whether or not to implement Enhanced Daily Checkpointing can: be made 
separately for each User Daily job (i.e., the same decision does not have to be made for all 
User Daily jobs). 


Implementation of Enhanced Daily Checkpointing requires definition ofi a second Date 
Control reco11d in the Date Control Record member. (The fol"mat of this record is described 
below in "Create Date Control Records.") This second record stores info11mation, which 
identifies jobs already ordered to the Active Jobs file. This, in turn, allows New Day 
processing to continue orderingjobs without redundancy. 


Create Date Control Records 


Date Control records are members in' the CONTROL-M PARM lib11ary. A Date Control 
record must be defined for the New Day procedure, and for each User Daily job a different 
Date Control record must be defined. 


If Enhanced Daily Checkpointing is implemented, a second Date Control record must be 
defined· for each User Daily job. 


A User Daily Date Control, reco11d has an 80~character length~ It is usually defined only 
once for eachjobj and: from then' oni it is usually updated 1 by the User Daily job, Format ofi 
the dates added to the record is mmddyy, ddmmyy 011 yymmdd~ depending on the site 
standard. 


The New Day p11ocedure Date Control1 reco11d 1 differs from the User Daily Date Control 1 


record in, that it has one additional date: Date7. The following chart shows the format ofi 
the Date Control' record). and, indicates when the Use11 Daily adds the 011iginal scheduling 
date values to the fields in1 the record: 


Column 


01-06 


18-23 


43~48 


50-55 


3-14 


Value added 
Description 


datel 
Use11 Daily adds the ODATE befo11e the User Daily 


pl"ocedur:e is begun. 


date2 
User Daily adds the ODATE befo11e the job, ordering 
process begins fo11 jobs being scheduled based on 
DATES, DAYS and/or DCAL paramete11s. 


date3 
User Daily adds the ODATE afte11 the job ordering 
process ends fo11 jobs being scheduled based, on 
DATES, DAYS and/or DCAL parameters .. 


date4 
User Daily adds the ODATE before the job ordering 


pl"ocess begins for jobs being scheduled based on, 
WDAYS and/or WCAL parameters. 


date5 
User Daily adds the ODATE after the job ordering 
process ends for jobs being scheduled based' on, 
WDAYS and/or WCAL parameters. 
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60-65 
blank 


(date7) 


67-72 
date6 
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In the User Daily Date Control, records, these 
columns are blank. 


In the New Day procedure Date Control1 reco:vd, 


these columns are the last fo:vmatting date, date7, ofi 
the Active Jobs file (used. by p:vogram CTMFRM). 
This field prevents formatting from being carried out 
twice on' the same day. When this date is in a record, 


program CTMCHK recognizes the record as a New 
Day procedure Date Control1 record. If there are any 
problems concerning the date, the program presents 
the operator with a series of pvompts. 


User Daily adds the ODATE upon completion of all 


processing. 


The format of the second Date Control record, which is required only if Enhanced Daily 
Checkpointing will be used1 is showw below. 
' 


Columns 


01-04 


05-12 


13~23 


24-28 


29""37 


38-42 


43-49 


Constant or Value added 


JOB= 


blank 


Constant 


In this area, CONTROL-M stoves the MEMNAME 
value of the last orderedjobi 


.SERIAL_NO= 
Constant (note the period befove the "S"). 


blank 
In this area, CONTROL-M stoves the intemal 


sequence number it assigned to the last orderedjob. 


. ORDERID= 


blank 


. GROt:JP= 


blank 


Constant (note the period befove the "0") . 


In this area, CONTROL-M stores the order ID of the 
last ordered job. 


Constant (note the period before the "G") . 


In this area, CONTROL-M stoves the group name of 


the last ovdered job. 


When· creating this record, the user should: 


• Specify the indicated constants (e.g., JOB) in the app:vopl'iate columns. 


• Leave blank the columns indicated as blank. These columns are filled in by the User 


Daily during processing. 


Ensure Subsequent Runs of Utility IOALDNRS if Necessary 


If all User Daily jobs are scheduled to run, in parallel, utility IOALDNRS only needs to· run 


once, after the User Daily jobs have finished execution .. If, however, the User Daily jobs 
are executed in groups at different times in the day, utility IOALDNRS should run aftev 


each group of User Daily jobs is executed. This can· be ensured by having each group of 


User Daily jobs set the approp:viate prerequisite conditions to ensure the execution of 


IOALDNRS. 
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Programs Called During New Day Processing 


The most important programs in New Day processing are CTMILY and CTMILU. 


• The New Day procedure executes program1CTMILY. 


• Each User Daily calls procedu:r~e CTMDAILY which executes pvogrami CTMILU. 


Programs CTMILY and CTMILU both execute other programs which implement New Day 
processing. The programs called by CTMILY and CTMILU are listed in1 the table below. 
Both CTMILY and CTMILU read the member referenced by DD statement DAPROG and 
activate the programs listed iw the member. 


The format for each record in the program list is: 


Columns 


01-08 


10-11 


Program name. 


Maximum return code· allowable in the preceding program, If a higher 


return code is encountered in the pveceding program) the current 


program' is not executed. 


The programs called by the program CTMILY (the New Day procedure) and by pvogram 
CTMILU (User Daily jobs) are shown in the following chart: 


CTMCHK 
.,/ 


CTMFRM 
.,/ 


3-16 


Checks the current date and its relation to· the 
Date Control1 recovd (see below). The program' 
may communicate with the computer operator to 
verify that CONTROL-M is activated on: the 
correct date. 


Reformats the CONTROL-M Active Jobs file and 
the IOA Conditions/Resources file: 


CONTROL-M Active Jobs File 


By 
default 
(i.e., . if not SELECT/IGNORE 


statements are specified). the following jobs are 
erased: from the Active Jobs file and the file is 
compressed: 


• 
Jobs which have already executed and ended 


OK or NOTOK (regardless oi parameter 
MAXWAIT). 


• 
Job whose MAXWAIT parameter has been 
exceeded. 


• 
Emevgency jobs which are not needed. 
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CTMEDA 
,/ 


CTMJOB 


CTMPDA 
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IOA Conditions/Resources File 


This program erases all p11erequisite conditions of 
the coming execution date. 


(Prerequisite conditions should not be kept in the 


IOA Conditions/Resources file fo11 more than one 
year. Otherwise, jobs may be submitted for 
execution due to prerequisite conditions set on 
the same date in the preceding year.) 


At start of execution, this p11ogram creates a copy 


of the Active Jobs File for recovery purposes. 


Signals to the CONTROL-M monitor that the 
Active Jobs file was successfully fo11matted. 


Places job 011ders in the Active Jobs file according 
to the date in the Date Control' record and the 
data in, the scheduling table(s) supplied, 


Marks the end o:Hhe Daily run, 


If CONTROL-Ris installed, step DELARCH is run after the conclusion of program CTMILY. 


This step runs the following: 


Deletes archived SYSDATA of jobs that were 
deleted from the Active Jobs file by program 


CTMFRM. 


Use of the Date Control Record by User Daily Jobs 


The wo11k flow of User Daily jobs is dependent on the Date Control' record .. The main steps 
of a User Daily job are: 


• Checking the last running date of the Use11 Daily job (via internal program CTMCHK). 


The first date in· the Date Control record (column' 1-6) is compared to the current working 
date (at the time o:Hhe run). 


- 
If they match, the User Daily job has already run today. An appropriate message is 
issued and the condition code is set to· 0004. 


- 
If the current wo11king date is earlier than the first date of the Date Control1 reco11d, a 
User Daily job run, has been attempted before its time .. The User Daily job stops 
executing and notifies the user accordingly. 
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- 
If the current wol'king date is later than the first date of the Date Control record (the 
normal situation~, the fir:st date of the Date Control recor:d (columns 1-6) is updated 
automatically to· the current wo11king date. This date is then used as the current 
scheduling date. 
If the User Daily job did not run for more than one day, a warning message is issued and the 
User Daily job tries to schedule the jobs fo11 all of the days which have passed since the last 
scheduling date (according to the production parameters). 


The New Day procedure asks the operator a series of questions regwding the current 
system date (see "New Day Procedur:e Flow," below). This verifies that an: incorrect date was 
not inadvertently entered duJ.'ling the IPL p11ocess. 


• Placing job· Ol'ders in' the Active Jobs file according to· the current scheduling date and the 
last running date (via internal program CTMJOB). 


Program CTMJOB acts on,the user schedulingtable(s) referenced.by DB statement DA:JOB. 


For each job in the table(s), the program checks whether the job. should be scheduled on one 
or all! the days that have passed since the last original' scheduling date (date3 ·or date5) untili 


the working date in, the record (datel). If the job should be scheduled, a job 011der is placed in 
the Active Jobs file. 


Fo:ri example, if a computer did not operate fromi the 20th to the 23l'd, a job, which was 
scheduled to run 1 on the 20th did not run. Program CTMJOB decides whether 011 not the job 
should be retroactively scheduled to· run on the logical 
1 date of the 20th. (See pwameter 
RETRO in 
1Section 3 of the CONTROL-M User Manual,) 


When the program' finishes processing the user scheduling table(s), the finish indfoator 


dates (date3 and date5) are updated to the wo11king date (datel) calculated by program 


CTMCHK. 


Befol'e program CTMJOB starts operating, it compares date2 with date3 (and date4 with 
date5).Jfthey do not match, a previous run o£program CTMJOB of the same User Daily job 
has probably abended. The user is notified and.the program terminates. To comect the error, 
adjust the date values in the user Date Control record (using a standwd edito11). 


Note 
When manually modi/Ying the Date Control record,. make sure that jobs are not 
scheduled to run twice on the same day. 


• Indicating that the User Daily job has ended (via program CTMPDA). 


Program CTMPDA updates the finish indicator date (date6) by inserting in' it the value of 
the running date (datel). This indicates that the User Daily job finished successfully. 


• Rerunning the User Daily job after a failu11e. 


See "Enhanced Daily Checkpointing" below. 


Enhanced Daily Checkpointing 


Enhanced Daily Checkpointing enables automatic rerun of the job ordering p11ocess, 


starting from the unsuccessfully 011dered job, if the User Daily job terminates during job 


011dering (due to a system crash, etc;). 


Befo:ve the ordering process starts, the program checks if the checkpoint fields in Record 2 · are 
blank. 
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If the checkpoint fields are blank, the Usen Daily job continues normal processing. Before 
each job is ondered, the fields in Reco11d 2 a11e updated (overwritten) with information 
identifying the current job being ordered. Only upon successful completion of the User 


Daily job is the infonmation in the checkpoint fields erased. 


If the checkpoint fields are not blank, the recovery procedure is activated. 


Recovery Procedure 


The program passes over the jobs in the input tables, internally counting the jobs and 
comparing the count to the value in the SERIAL_NO field, untH the count and serial 
number match. The matching job is selected. 


The program then compares the values in the JOB and GROUP fields to the values 
belonging to the selectedjob; If the fields do not match, error message CTMD67S is issued 
and pnocessing terminates. 


• If the fields match, the program checks the Active Jobs file for a job with an onder ID 
matching the 011der ID recorded in Reco11d 2. If the match is found, an additional check is 
performed to verify that the job's MEMNAME and GROBP values match the checkpoint 


JOB and GROUP values. 


• If the Active Jobs file already contains the job, the job is not 011dered again and the program 
switches to normal processing starting with the next job. 


• If the Active Jobs file does not contain the job, the job is ordered~ The program then switches 
to nonmal, processing~ 


Note 
If relevant scheduling tables are modified prior to rerunning the User Daily job, the 
checkpointedjob and serial number may not match. In this case, automatic rerun is 
terminated, but rerun can be initiated manually. 


New Day Procedure Flow 


Once a day, at a time set by the IOA administrator, the CONTROL-M monitov begins New 
Day processing by going into a suspended state and issuing the following messages (the 
first is a highlighted, unrollable message): 


C'l'M113I CONTROL-M MONITOR monitor NEW DAY PROCESSING STARTED 


C'l'MLOOI CONTROL-M MONITOR monitor PROCESSING SUSPENDED 


C'l'ML07W CONTROL-M MONITOR monitor WAITING FOR NEW. DAY PROCEDURE 


Sho11tly after that last message is issued, started task CONTDAY (the New Day procedure) 
is automatically activated. 


• When CONTDAY finishes executing without any problems, the following messages are 


issued; and the CONTROL-M monitor ends its suspended state and resumes processing: 


C'l'MLO[I CONTROL-M MONITOR monitor PROCESSING RESUMED 


C'l'ML02I CONTROL-M MONITOR monitor NEW DAY PROCESSING COMPLETE 


• If a problem occurs during CONTDAY processing, the CONTROL-M monitor prompts the 
operator for an approp:viate response via the following messages: 


C'l'ML05W NEW DAY PROCESSING ERROR DETECTED 


C'l'ML06W. REPLY 
0 R" FOR RETRY OR 
0 E° FOR END 
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The operator should try to correct the p11oblemi and request that CONTROL-M retry New 
Day processing~. Halting New Day processing (option E) should only be requested if the 


problem cannot be corrected, 


• During New Day processing, CONTDAY checks the system' date and, time against what it 
expects to find· in' the CONTR0L-M control 
1 files. If fo11 some reason, they do' not match~ the 
operator is prompted with the following messages:· 


CTM426W GENERAL nDA:rLYn D:tD NOT RUN FORnnnnnn DAYS 


CTM427W :rs :r'l' TRUE? (ANSWER "YESn OR nNO") 


CTM428W YOUR ANSWER :rs: 


This situation may occur afte11 the computer has not been working fo11 a few days (e.g., a 
hardware failure or holiday); your response should be YES. If this is not the case, it is 
probable that the computer was IPLed with the wrong date: Your response should be NO, 


andthe date onthe computer shouldbe checked and corrected. Then start CONTDAY again. 


If the date on1 the computer is conect, the JOA administrato11 should be called to check the 
cause of the problem. 


Notes 
To rerun User daily jobs from the beginning (after a failure) all dates (1-6) must 
restored to} their previous value before attempting the rerun. 


If the CONTROL-M monitor has been down for more than 28 days, the previous 
working date (i.e., the current working date minus 1) should be manually specified as 
values 1-6. 


Activation of Started Tasks 


CONTROL-M can, activate started tasks as well as jobs. The JES2/JES3 definitions 
required to support sta11ted tasks are described in, the CONTROL-M section of the JOA 


Installation' Guide. 


When working in a multi-CPU environment, CONTROL-M can also activate started tasks 
in' CPUs other thani the one in which the CONTROL-M monitor is active. 


Under JES2, the CONTROL-M monitor activates started tasks in other CPUs by using 
command, $Mm1. where m is the approp11iate system ID. This system ID is defined in, the 


JES2 initialization check as follows:. 


MASDEF S:tD(n)=cccc 


or 


sn s:rD=cccc (under older releases) 


For further details, refer to IBM~s publication "JES2 Initialization and Tuning" (SC23~ 
0046 or equivalent). 


Note that JES2 will fail a $Mmi command if mi is the ID of the system ID in which the 


CONTROL-M monitor itself is working. The11efore, when CONTROb-M is ordered to 
activate a started task in a specific system, it checks whether a $Mm command or a 
regular MVS START command should be issued. To ensure that this check is performed 
correctly, you must define in the CPUS installation parameter (in1 CTMPARM) all the 


CPUs in your computer complex. 
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Under JES3i the CONTROL-M monito11 activates started tasks in other CPUs by issuing a '*T 


cccc' JES3 command, where "*" is the JES3 command prefix, and cccc is the required system 
ID. This systemiID is defined in' the JES3 initialization deck (INISii:IDECK) as follows: 


MAINPROC,NAME=cccc,SYSTEM=JES3, ••• 


CONTROL-M Monitor and JES Considerations 


Cases of JES Malfunction 


The CONTROL-M monitor uses JES services to receive information about the status of the 
jobs running in the system, If CONTROL-M detects a critical error in JES operation, it 
shuts itself down .. This prevents the incorrect submission of jobs due to a JES malfunction. 


One of the following highlighted, unrollable messages is displayed on the operator console: 


CTM168S CONTROL-M SHUTTING DOWN - 
COMMUNICATION TO "JES" NOT AVAILABLE 


CTM256S CONTROL-M SHUTTING DOWN - 
COMMUNICATION TO "JES" NOT AVAILABLE 


Special Considerations 


To analyze how a job finished executing, CONTROL-Muses JES services to read the job's 
output. Therefore, the following limitations should be considered: 


• Jobs submitted by CONTROL-M can, be canceled by the operator. It is important, however, 
not to purge their outputs (i.e., JES commands $FJnnn, $CJnnn, P and, other similar 
commands must not be used~. 


• Job output fo11 jobs submitted by CONTROL-M should not be released for printing other 
than1 by CONTROL.-M (i.e., MVS JES2 command $TO, MSF JES command $0, or other 
similar commands should not be activated. on the job\s output). 


• If JES operator command $HJ is issued for the job, the job must be released from held 
status before CONTROL-M can read the job'.s output. Otherwise, the job status is changed to 
EXECUTING (SYSOUT IN HObD STATUS). 


Whenever the CONTROL-M Monitor does not succeed in reading job sysout, the following 
rollable message appears on, the operato11 console: 


CTM262W 
n UNSUCCESSFUL ATTEMPTS TO READ JOB DATA BY SUBSYSTEM REQUEST. RETRY 


CONTINUES 


Message CTM262W does not necessarily indicate a serious problem. 


Examples 


• When a job is not run due to a JCL error, only two sysout datasets exist for the job, 


Therefore CONTROL-M cannot read the third sysout dataset, and the above message is 
displayed. 


• When, JES is very busy, a period of up to a minute (iil. extreme cases) may pass between the 
time the job has finished executing and the time JES enables CONTROL-M to read its 
sysout (i.e., JES is "stuck" in the Output Processing stage). 
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By default, CTM262W is displayed every 5 times the CONTROL-M monitor attempts to 
read the job sysout and does not succeed. If after 20 attempts the CONTROL-M monitor 
still does not succeed in reading the sysout, the following message is displayed: 


C'l'MD50S 
READiNG JOB DATA BY SUBSYSTEM REQUEST FAiLED AFTER n ATTEMPTS. LAST 
RC code FiLE n jobname/jobid 


The above two.default values can be changed using installation1 defaults. 


On the othe11 hand, message CTM262W can indicate serious problems with the job's sysout. 
Below is a list o£typical p11oblems which can cause this message to· appear. 


• When a job~s output has been released for print (Le., no longer in held output), the job's 
output should be printed 011 purged~ 


• In a multi-computer environment the following chain 0£ events may occur: 


- 
CONTROL-M monitor submits the job from: computer A 


- 
Computer A crashes (or is shut down) 


- 
CONTROL-M monitor is activated on' computer B and the job executes in computer B. 
When the job finishes executing CONTROL-M cannot read the job's output and message 


CTM262W appears. 


This is caused by the job waiting to be "handled" by the JES of computer A. 


This problem can be overcome by assigning the job to computer B (using the JES 


command:. $TJnnn,S=sysid). CONTROL-M then reads the output, and the message 
disappears from the operator console. 


Message CTM262W Summary 


Whenever message CTM262W appears, wait a minute or two. If the message continues to 
appear every few seconds fo11 the same job, try to resolve the problem, by following the 
following steps: 


Note 
To stop. the message from appearing on the operator console while you are checking the 
problem, hold the job order in the CONTROL-Ml Job Status screen (screen 3). 
Remember to release it once you have resolved the problem. 


• Issue the JES2 command $DJnnn, and scan the results. 


• Check whether 011 not the job~s output is in held class (the job waits fo11 pl'int) .. If yes, the 


CONTROL-M monitor cannot analyze the output, so you must analyze it manually. Print or 
purge the output of the job •. Make sure that the job order in1 CONTROL.-M is not HELD. 
Wait for a minute untilthe status of the job changes to DISAPPEARED. Do not forget to 


ADB/DELETE conditions according to the result of the run. Do this manually in· the IOA 


Conditions/Resources screen (Screen· 4). 


• If the job is "waiting for output p11ocessing," check whether 011 not the job (not the output) is 
held (by a p11eviously issued $HJ, command). If the job is held, release it using the JES2 


command $AJnn. 


• If the job is "waiting f011 output processing" by a system ID which is currently not active,.try 
to resolve the problem using the $TJnn command1method described above. 
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Considerations for Changing Clocks 


Daylight savings time considerations ave described in the following paragraphs. All 
examples assume 02:00 a.m. as the time of change. 


Advancing the Clock Forward 


The CONTROL-M monitov should not be bvought down when the clock is being advanced. 
This applies to computers that al'e capable of changing the clock without restarting the 


system, 


New Day Procedure 


No special action, should be taken once the clock is advanced. 


• If the New Day procedure starts befol'e you reset the clock, the New Day pl'oceduve will 
start working before the clock is advanced, and will' continue normally (even if the clock is 
advancedwhile the New Day procedure is in process). 


• The same consideration applies if the New Day procedure is scheduled to begin at exactly 


2:00 a.m. It is possible that the New Day procedure will start execution, befove the clock is 
manually changed. Otherwise, changing the clock win initiate New Day processing. 


• If the New Day procedure is to begin between 2:00 a.m, and 3:00 a~m., once the computer 
clock is advanced the monitor will start the normal' New Day processing. 


• If the New Day procedure will begin after 3:00 a.m,, no action, is required~ The monitor will 
start the standard New Day procedure. 


Time-Dependent Shouts 


• Shouts scheduled before 2:00 a.m. do not require any action, 


• Shouts scheduled at the time between 2:00 a.m. and 3:00 a.m, will be issued, even though 
there might not be a real delay in production, since the time frame fov the pl'oduction is 


small~r. 


• This also applies to jobs which have a shout scheduled at a later time (e.g., 6!00 a.m.). These 
jobs may be considered late jobs because of the tighter production time frame. 


Time-Dependent Schedules (FROM UNTIL) 


Jobs whose scheduled time ovelllaps the time gap created by the clock shift may need 
manual intervention~ For example, it is possible that a job with a FROM value of 2:15 a.m., 


and an UNTIL value of 2:45 a.m. might not be submitted at alL These jobs should be 
manually adjusted. 


IOALogFile 


Just like the system log, the IOA Log file will not contain entries with a timestamp between 


2:00 a.m. and 3:00 a.m, Any KSL scripts and/ov programs that rely on the time of the log 
entry should be checked for a possible discrepancy as a result of advancing the clock. 
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Moving the Clock Backwards 


The following examples assume that the clock is moved back at 2:00 a.m., i.e., 2:00 a.m. 
becomes 1:00 a.m. 


New Day Procedure 


• If the installation' New Day time is before 1:00 am, then no special action, should be taken. 
The New Day p:r~ocedure will' run only once (between 00:00 and 00:59). 


• If the newday time is exactly at 1:00 a.m., then the computer time should not be turned back 
to 1:00 a.m,, as this will! initiate another newday process, and a second newday process 
requires a manual intervention. It is advisable to wait until 2:01 a.m,, for example, and then 


turwthe clock back to 1:01 a~m, 


• If the New Day time is between: 1:00 a.m. and2:00 a.m., do one of the following: 


1. Wait until at least a full hoU11 has elapsed from the daily run, and then tum the clock 
back to a time which is past New Day time. 


2'. Update the clock before New Day processing begins. 


For example, if the New Day time is 1:45 a.m., the clock should be moved back one hour 
no later than 1:44 a.m. If this was not done by 1:44 a.m., then the user should, wait until 
2:46 a.m. and then shift the time back. 


• If New Day time is after 2:00 a.m., no. special: action should' be taken. 


Time-Dependent Shouts 


Certain shouts scheduled between 1:00 a.m. and 2:00 a.m,, may be issued twice. 


Time-Dependent Schedules (FROM-UNTIL) 


No special action, should be taken for jobs with FROM-UNTIL schedule. Jobs scheduled to 
start at a time between 1:00 a.m. and 2:00 a.m~ will start at the first occurrence of that 
hour (provided that other conditions, such as input conditions, resources, etc. are met). 
However, they may be restarted once the clock is moved back. 


IOALogFile 


The IOA Log file will contain entries with a time which is earlier than previous entries, 
due to the time shift. The same considerations which apply to forward clock shift should be 
applied to the IOA Log file. 
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Sending a Job's SYSDATA to a Held Output Class 


CONTROL-M analyzes job execution results by reaQ.ing the job's sysout. Therefo11e, the 


SYSDATA2 portion, 0£ the job must be sent to a held output class to p11event it from being 
p11inted accidentally before the CONTROL-M monitor manages to· read it. 


HLDCLAS is the automatic held output class to which: CONTROL-M sends the job's 


SYSDATA output. 


When a job is submitted by CONTROL-M, CONTROL-M either adds a MSGCLASS 


parameter to· the job card or it overrides the existing MSGCLASS parameter. The sysout is 
directed to the class designated in the HLDCLAS installation parameter. It is required 
that a regular automatically held output class be specified during installation~ 


Special p11ecautions should be taken so that the job!s sysout is not accidentally purged 011 


released for printing. In some installations, all jobs in, the automatic held class a11e purged 
by an operatoll command at least once a day. To p11event deletion, befo11e CONTROL-M 
reads the job's sysout, the following pllocedure can, be used: 


• A special automatically held output class is dedicated to CONTROl!rM. 


• The sysouts in this class are protected from any change (e.g~, by SDSF exits). 


This p11ocedure ensures that CONTROL-M will be able to read the sysout. 


If other users are to access the sysout, the following sample paramete11s should be defined 
in any job.production: parameters definition= 


ON PGMSTEP ANYSTEP 
CODES ***** 


DO SYSOO'l' 
OPT C 
PRM A 
FRM X 


When CONTROL-M finishes reading the job's sysout, it transfers the sysout to the 
designated output class where any user can, access it. 


Special care should be taken when a system programmer formats the JES queue. This 
p11ocedure usually involves unloading the output queues to a tape, follmatting the spool, 
and then reloading the queues. The monitor should be shut down befo11e the queue is 
unloaded to a tape, and b11ought up again only after the queues have been loaded from the 
tape back to the spool. If this procedure is not followed, CONTROL-M can assume that the 
job is lost (purged by an operatov) and act accordingly. 


When you change the HLDCLAS parameter after CONTROL-M installation1 you should 
also change the class in DD statement INTRDR 0£ the CONTROL-M monitov, and 0£ JCL 


p11ocedures CTMAESIM and CTMTAPUL. 


2 SYSDATA is an IOA term used to designate the data in the following job sysout datasets: 


1. The job log (console messages) 


2. The expanded JCL 


3. The system output messages 
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Dual Checkpoint Mode 


The CONTROL-M monitor can, work in, dual checkpoint mode. Under this mode, the 


CONTROL-M monitor maintains duplicate copies (mirror files) of: the CONTROL-M Active 
Jobs file and of the IOA Conditions/Resources file. In 
1 case of: a disk crash which makes the 
regular files inaccessible, these files can immediately be restored from' the mirror files 
(assuming, of: course, that the mirror files are located on a different disk). 


The Active Jobs Mirro11 file is kept synchronized with the main Active Jobs file by the 


CONTROL-M monito11. The Mirror file should be p11otected fromi any update fromi another 
source .. If either of: the two files is damaged during CONTROL-M operation, the 


CONTROb-M monito11 will shut down with an appropriate message. To resume 


CONTROL-M monitor operation, the damaged file must be restored~ 


Restoi;ing the Active Jobs file involves the following stages: 


• Allocate and, format a new Active Jobs file (via utility CTMFRCKP). 


• Run utility CTMCAJF. Use the undamaged Active Jobs file as input and the newly created 
one as output. 


• Rename the damaged. file and rename the newly created Active Jobs file with the original 
file name (the Main oi; the Mirror) .. 


• Restart the CONTROL-M monitor. 


Restoi;ing the· Conditions/Resom~ces file involves the following stages:· 


• Allocate and format anew Conditions/Resources file (via utility IOAFRRES). 


• Run, utility IOACOPRS. Use the undamaged Conditions/Resou11ces file as input and the 
newly created one as output .. 


• Rename· the damaged file and rename the ·newly created Conditions/Resou11ces file (RES and 


SNC) with the original1file name (the Main or the Mirror); 


• Start the CONTROL-Mmonitor again, 


Managing the Cl\IBM Facility 


The CONTROL-M Event manager (CMEM) is designed to handle events occurring outside 
the control1 of the CONTROL-M monitor. CMEM consists of: a monitor which uses the IOA 
subsystem, and performs predefined 
1 actions in response to systemi events (e.g., arrival of a 
specifiedjob on the job spool). 


Note 
When CONTROL-0 is installed at your site, the CONTROL-0 monitor assumes 
control of the CMEM facility; Therefore, this description of the CMEM facility is not 


relevant for your site. Instead, refer to Section 5 in this guide for information on how to 
manage the CMEM facility at your site. 
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Automatic Loading of Rules 


When1 the CMEM facility is stal'ted (and. it is not replacing an· active CMEM monitor) it loads 


CMEM rule tables according to a list referenced by DD statement DACTMLST. This list of 
CMEM rule tables is called the CMEM list. A default list is located in member IOACMEML 


in the IOA PARM libl'ary. The CMEM list is a partitioned dataset (PDS) containing the 
names of the tables to be ordered~ The default list can, be overridden by specifying the 


ORDER parameter in1 command S CTMCMEM, which references a different CMEM list. 


Each line in the CMEM List has the following format: 


* 
library table 


Where: 


* 


libl'!ary 


table 


Must be included as a constant. 


Rule library name; 


Rule table name (or mask). 


CMEM loads the specified rule table from the specified library fol' each line in the CMEM list. 


Manual Loading of Rules 


The CMEM list specified during startup contains a list of rule tables to be activated by 


CMEM when' it is started. 


To, load' additional 
1 tables, or to replace a currently active table with a new (updated) copy 


of the rules in, the table, use one of the following options: 


Option 1 


Enter the CMEM Online facility (=C), and use the FORCE optioninthe Table List screen. 


Option 2 


Issue the· following opera to I'! command: 


F C'l'MCMEM,C=library(table) 


Where: 


Load a CMEM rule. Each' rule is loaded by the CMEM monitor and is 
activated. 


library 


table 


Examples 


Rule library name. 


Rule table name (ol' mask). 


F C'l'MCMEM,C=C'l'M.PROD.RULES(DATASET) 


Loads table DATASET from CTM.PROD.RULES 


F C'l'MCMEM,C=C'l'M.PRC>D.RULES{*) 


Loads all tables from CTM.PROD .RULES 


F C'l'MCMEM,C=C'l'M.PROD.RULES(PRC>D*) 


Loads tables starting with PROD from CTM.PROD.RULES 
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Replacing All CMEM Rule Tables.in One CPU 


To replace all loaded CMEM tables with those in the CMEM list (specified in DD 
statement DACTMLST) use the following operatov command: 


F C'l'MCMEM,C=ALL[,REBU:CLD] 


If the REBUILD option is specified1 CMEM rule tables not listed in the CMEM list are 
deleted. 


If the REBUILD option1 is not specified, pveviously loaded CMEM rule tables are replaced 
by a new copy ofi the rule table, and unchanged: tables are left intact. 


Replacing All CMEM Rule Tables in All CPUs 


AU CMEM rules in aU CP"C:J s where the CMEM monitov is active can, be reloaded at the 
same time. The reload process is performed in: the same way as the automatic loading is 
performed during stavtup 1 0£ the CMEM monito11. All active rules are deleted, and all rule 
tables specified in the CMEM list referenced by DD statement DACTMLST are loaded. 


To replace all rules in all CPUs issue the following command: 


F CON'l'ROLM,NEWCONL:CST 


Specifying this command is the same as specifying F CTMCMEM,C=ALL,REBUILD in all 


CPUs. 


CONTROL-M informs the CMEM monitov running in, each CPU about this command 
request. 


Rule tables that were manually loaded and/or do not appear in the CMEM list al'e deleted 
during execution ofi the above operato11 command'. 


Deleting (Deactivating) an Active Rule Table 


An active CMEM rule table can be manually deactivated via the following operator 
command: 


F C'l'MCMEM,D=library(table) 


Where: 


D= 


library 


table 


Example 


Deactivate a CMEMrule .. Eachrule is deactivatedbythe CMEMmonitor. 


Rule library name. 


Rule table name (or mask). 


F C'l'MCMEM,D=C'l'M.PROD.RUIIES(PRODTAB1) 
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Displaying Active Rules 


A list ofi the active CMEM rules (up to a maximum of 1000 rules) can be displayed on' the 


operato11 console. To display the list enter operato11 command: 


F C'l'MCMEM,DZSPLAY 


This command displays a list of! all active rules in the CMEM facility with the following 
information: 


Rule 
Rule name (i.e., the name which appears in the first ON statement in the 
rule definition~. 


Type 


Table 


Status 


Library 


Priority 


Rule type. Valid types are: 


R 
JOBARRIVAL 


X 
J0BEND 


D 
DSNEVENT 


Z 
STEP 


Name of the table containing the rule. 


Rule status. Valid, status is ACTIVE .. 


Name of the library containing the rule member. 


lnternal1 CMEM rule scanning priority. 


Controlling CMEM Rule Operation Mode 


The mode 0£ operation1 (i.e., the trace mode) for a rule is determined by parameter MODE 
in its rule definition. Sometimes it is useful to override the operation mode of! all active 
rules and verify that events and actions are recorded in a particular way. For example:. 


• Ensure a full trace of all rules (i.e.,. all events and actions are recorded) to· facilitate analysis 


0£ the interaction between rules. 


• Reco11d (trace) only the triggering of every rule .. 


Global1 trace operations are requested via operator commands, as follows: 


1. Activate a fuU trace: 


F C'l'MCMEM,LOG=ALL 


All! rules are fully traced as if! they were defined with mode LOG. This operator command 
should only be used temporarily for specific tests because extended use of full trace mode 
can adversely affect CMEM performance. 


2; Trace rule triggering only: 


F C'l'MCMEM, LOG='l'RZGGER 


Only rule triggering is traced for all rules. However, rules defined with mode· LOG are fully 
recorded. 


3. Resto11e the default operation mode (as defined in the rule definition) for each rule: 


F C'l'MCMEM,LOG=DEFAUL'l' 
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Modifying the CMEM Sleeping Interval 


CMEM "wakes up" every few seconds. This time interval is defined' in, the CONTROL-M 
installation parameters and, can, be changed, by the system administrator. In: addition, the 
interval can: be modified by the operator command: 


F 
CTMCMEM,:CN'l'ERVAL=xx 


Where xx represents the interval in seconds .. 


When the modification is accepted by CMEM, the following message appears on the 
operator console: 


CME123:C CMEM :CNTERVAL :CS SE'l' 'l'O nn SECONDS 


Refreshing the CMEM Security Cache 


CMEM security modules use a security block to identify each user for which' an authority 
check is performed~ The first time a user's security authorization is checked CMEM creates 
a security block for that user. The security block can1 then optionally be saved for the next 
time the user's security authorization is checked. 


Security blocks saved for subsequent checks are kept in, the CMEM Security Cache. 


The CMEM Security Cache holds security blocks for the last 30 users to have their 
security authorization checked. 


Changes made to a user's security authorization, (since the last time that user's security 
block was created) are not automatically included in 
1 the information in the user's secuvity 


block in the CMEM Security Cache. However if a user's security authorization has been 


changed; and there is no secu11ity block in the CMEM Security Cache for that user, 
changes made to, the user's security authorization, will be in effect the next time that user's 
security authorization, is checked. 


To immediately include new user authorization information: in the CMEM security cache, 
refresh the security cache via the following operator command:· 


F CTMCMEM,NEWSECDEF 


This command refreshes all user authorization infovmation in: the CMEM secuvity cache. 


When the modification is accepted, the folfowing message appeavs on: the operatov console: 


CME251:C RUNT:CME SECtJR:C'l'Y REFRESH ENDED OK 


Problem Determination 


CMEM is supplied with internal debugging facilities: The ability to print an internal 
debugging trace and the ability to print the contents of the CMEM internal data aveas. 
Under normal 
1 circumstances, the debugging facilities are dovmant. However, if required 
(i.e., your IOA repvesentative has requested debugging infovmation), it is possible to 
activate the debugging facilities as follows: 


Activate the CMEM internal trace: 


1. Perform either step A or B below. 
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A. Start a new CMEM monito11 with the follt>wing operator command: 


S C'l'MCMEM,DEBUG=xx 


The cura"ent CMEM monitor passes control1 to ·the new CMEM monitor and shuts down. 


011 


B. Issue the following operato11 command: 


F C'l'MCMEM,DEBUG=level 


The requi11ed, debugging level! will: be supplied by your IOA representative. It can be any 


value fromi 00 to 255. (00 specifies no debugging.) 


Note 
It is highly recommended not to activate CMEM with the DEBUG parameter on 
a regular basis· because in case of a JES pnoblem, CMEM may· get hung up 
waiting for JES. 


2. The debugging information is printed to DD statements PRTDBG and DADUMP of the 
CMEM procedure. 


3. When you have finished your problem determination p:1~ocedures, start a new CMEM using 
the following operator command: 


S C'l'MCMEM 


or specify the operato11 command: 


F C'l'MCMEM,DEBUG=001 


Print CMEM Internal Data Areas 


To1p11int CMEMinternaldata areas, issue the following operato11 command: 


F C'l'MCMEM, SNAP [ =namel, name2 ••••• , namen] 


Where:• 


namel, name2; .... namen are the names of the CMEM internal data areas. 


When1 no: name is specified, all data areas are printed. Your IOA rep11esentative cani 
provide you with the list of the data area names and can specify which areas should be 


p11inted depending on the problem1 encountered. 


Valid values are:. 


ALL 


ALO 


CAS 


CONLIST 


CONS 


LINK 


MAIN 


MCT 


MTO 


MTOINX 


MTOPLB 
OMT 


MTOPND 
OPR 


MTOPNX 
PARM 


MTOSRV 
PND 


MTOSRVA RFR 


RQCEXO 
RQC 


RQCFREE 
RQH 


RQCMTO 
RULES 


RQCRFR 
SEC 


RQCSLO 


CONSOLE 
MTOI:.NK 
MTOWSC 
RQCALO 
RQCSRV 


SLO 


SRV 


SSCT 
DLY 
MTOMIX 
MVS 
RQCDLY 
RQCSTO 


EXO 
MTOMPT 
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STO 


SWT 


UCM 


VARS 


WISHES 


wsc 
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When: the snap is completed, the following message appears on the console: 


CME150~ SNAP COMMAND WAS PERFORMED SNAP~D=XXXX 


Where: 


xxxx is the snap identifying number which appears on: the lower right 0£ the screen, after 
the snap is completed, 


Displaying Internal Resource Utilization 


To obtain: information on' internal resource utilization, issue the following operato11 
command: 


F C'l'MCMEM,WA'l'ERMARKS 


The response to this command is displayed, as message CME15DI. See the IOA Messages 
and, Codes manual fo11 an explanation' of this message. 


Inter-System Communications Facility 


The CONTROL-M Inter-System Communications facility can be used' in multi-CPtJ sites 
which' run 1 the· following environment: 


• CPtJs which do not employ a shwed Spool! (i.e., each CPtJ runs its own: CONTROfr.M 
monito11) 


• CPUs which employ a shared DASD, with a global1ENQ manager (such as GRS, SDSI, MSX, 


MIM, etc;). 


This facility enables communication' between, multiple IOA monito11s in· different 
computers, p11oviding there is a shared disk between' them, 


Method of Operation 


When' a p11erequisite condition is added to or deleted from' the Conditions/Resources file, a 
request to add/delete that condition is also written to an Inter-System Communications 
file (a sequential file residing on' a shared disk). 


The CONTROL-M Inter-System Communications monitor (residing in, the other CPU) 


reads the conditions fromi the Communications file and updates the Conditions/Resources 
file o£the other computer. After the Conditions/Resources file is updated, the lnter-Systemi 


Communications file is emptied and is ready to receive new conditions. 


An, Inter-System Communications monito11 should, reside in every CPU which is to be 
connected. A Communications file must be created for each communication direction. 


3-32 
IOA Rel. 5.0.0 Administrator Guide 


. 
i 
\J 


u 


u 


u 


Section 3: Customizing and Administering CONTROL-M 


In the example below, conditions from CPUA are written to· CPUB via Communications file 


CTM.V500,COM2CPUB. Communication is also available in the reverse direction1 via the 
second Communications file CTM.V500.COM2CPUA. 


CPUA 
CPUB 


SHARED DASO 


ADD/DELETE 
lcTM.V500.COM2CPUBI 
• 
• 
CTMISCB 
CONDITION 
I 
I 


communication 
files 


CTMISCA • 
ICTM.V500.COM2CPUA I • 


ADD/DELETE 


CONDITION 


To. write requests to· the Communications file, additional program code must be· applied to 
exit IOAX007. A routine invoked by exit IOAX007 receives control' when' adding or deleting 
a condition, and writes the condition name to· a sequential file residing on a shared DASD. 


Not all conditions need to· be communicated between computers .. Therefore, the routine 
uses a condition· selection list which 1 is created by the user (described below). Only 
conditions which· fit the selection list are passed to· the communications file. 


Create the Inter-System Communication Files 


Edit member ISCALLOC in the IOA INSTCTM lib11ary. Co!1rect the job card, dataset 
names, etc;, submit the job, and save the member. The job allocates two sequential 
datasets (one for each CPU). 


Note 
The files should be allocated on shared DASD that is accessible for update from both 
CPUs. 


Prepare the Condition Selection List 


Create a member named ISCPARM in the CONTROL-M PARM lib11ary. The member 
should contain a list 0£ prerequisite conditions which should be communicated (passed) 
between the computers. The condition name can contain the following special characters: 


* can be used to substitute a string 0£ any length. 


? can be used to substitute fo11 any one character. 


Example 


COND=PAYROLL 


COND=J * ENDED 
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The following is passed:. 


• Condition PAYROLL, 


• All conditions whose names start with J. and end with ENDED 


Modify JCL Procedures and CLISTs 


The following DDNAMEs should be allocated in both computers acco11ding to the following 


rules:. 


For all procedulles/CLISTs running in1 CPUA: 


//DA:ISCOUT 
//DA:ISCPRM 


DD 
DJiSP=SHR1DSN=prefix.version.COM2CPUB 


DD 
DJiSP=SHR,DSN=prefix.version 1.PARM(:ISCPARM) 


For alt procedures/CLISTs running in CPl'.JB: 


//DA:ISCOtJ'l' 
DD· 
D:ISP=SHR:,DSN=prefix.version.COM2CPtJA 
//DA:ISCPRM 
DD 
D:ISP=SHR:,DSN=prefix.version.PARM(:ISCPARM). 


Add· two new DDNAMEs (described' above) to the following JCL p11ocedures: 


The CONTROL-M monitor 


The Online monito11(s) 


The IOACND Utility 


CONTROLM 


IOAOMONl 


IOACND 


IOARKSLx 
Fo11 all' KeyStroke Language ·procedures 


Logon Procedures 
For TSO and ISPF users 


Add, two new DDNAMEs (described above) to the following CLISTs: 


IOACND 


IOACCND 


IOAONL 


CTMCND Utility under TSO 


CTMCND Utility under TSO/ISFF 


Main1 IOA Online facility 


Copy JCL to Procedures Library 


Edit members CTMISCA and CTMISCB in the IOA PROCI:..IB lib11ary, adapt them to your 
data center naming conventions, copy them: to your procedures library, and save the 
members. 


CTMISCA should be copied to CPUA. CTMISCB should· be copied to CPl:JB. 


The PARM value in· members CTMISCA and CTMJ:SCB specifies the interval (in seconds) 
after which the Inter-System Communications monitor should wake up to receive 
prerequisite conditions from the second CPU. 


Verify that the CTMISCA procedure (running in CPl'.JA) has the communications file (for 


conditions coming from CPl'.JB) defined· to DDNAME=DAISCINl. 


//DA:ISC:CN1 DD·D:tSP=SHR:,DSN=prefix.version.COM2CPtJA 
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Verify that the CTMISCB p11ocedure (running in CPUB) has the communications file (for 
conditions coming from CPUA) defined to DDNAME=DAISCINl. 


//DAISCIN1 DD DISP=SHR1DSN=prefix.version.COM2CPUB 


The access to the communications files from both CPUs is serialized by the ENQ 
mechanism with SCOPE=SYSTEMS. 


The·QNAME is CTM. 


The RNAME is the file name allocated to DAISCINn or DAISCOUT. 


Verify that the above names are included in the list 0£ QNAMES/RNAMES managed by 
your globalresource serialization p11oduct (GRS, SDSI, MSX, MIM, etc.). 


Customize the Exits 


Member IOAX0071 in the IOA SECUDATA lib11ary is a sample 0£ IOA exit IOAX007 which 


invokes the CTMISR routine (the routine used to write the conditions to the 
communication file). If you do not use exit IOAX007 at your site (i.e., the default dummy 
exit is used), you can use the p11ovided IOAX007 sample as is. If you• already use exit 


IOAX007, you can use the sample exit as an example 0£ how to include a call to CTMISR in 
the exit. 


Modify your IOAX007 exit or use the provided sample. Assemble and link-edit the exit .. If 
different IOA Load lib11aries are used in each computer, the assemble and link,..edit should 


also• be performed in the second CPli. 


Start the Communication Monitors 


Start the CTMISCA communication monitor in• CPUA and the CTMISCB communication 
monitor in CPUB. Check that they are up and running, and that there are no erro11 


messages. 


Shut down• and start the CONTROL-M monitor, the IOA Online monito11, and TSO 


sessions. 


Enter option 4 of the IOA Online facility. Add a condition which should be communicated 
between the computer:s. Ver:ify that it was added in the other computer's IOA 


Conditions/Resources file. 


Expanding CONTROL-M Files 


Follow the steps below to expand CONTROL-M files. 


Expanding the Active Jobs File (CKP) 


1. Shut the monitor. Specify the following operato11 command: 


P CON'l'ROLM 


2: Rename the old CKP and BKP files to have a different name. 
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3: Select step "Customize Dataset Parameters" from the CUSTOMIZE activity in ICE .. Change 


the value of pwameter CKPSIZE to the required: value. Complete the remainder of the 


minor steps for this step· to update and compile member CTMPARM, and customize the 
formatting jobs. 


4. Edit member FORMCKP in the IOA INSTCTM library. Check CKPSIZE, and submit the 
job .. This job will 
1 allocate and' format a new set of CKP or BKP files with the new size. 


5. Run the CTMCAJF utility with the COPY parameter to: copy the old CKP file into the new 
one. 


6: Start the monitor. Specify the following operator command: 


S CONTROLM 


Expanding the CONTROL-M Jobs Dependency Network File 
(GRF) 


1. Close the·monitor using the following operator command: 


P·CONTROLM 


2: Rename the old 1 GRF file to have a different name. 


3: Edit member FORMGRF on the IOA INSTCTM library, change pwameter SIZE to the new 
requested size and submit the job for run. This job willi allocate and, format a new GRF file. 


4. Bring the monitor up.using the command: 


SCONTROLM 


5. Once the monitor is up issue a modify command: to re-calculate files dependency: 


F CONTROLM,NE'r 


Expanding the CONTROL-M Statistics File (STAT) 


1. Shut down the monitor. Specify the follt>wingoperator command:· 


PCON'l'ROLM 


2:. Rename the old STAT file to a different name. 


3: Edit member DEFSTAT in: the IOA INSTCTM lib11ary. Change pwameter cylinders to the 
new requested size CI size. 


4. Submitjob FORMSTT in:the INSTCTMlib11ary. 


5. Copy the old STAT file into the new file using IDCAMS REPRO. 


6: Start the monitor. Specify the following command: 


s· CONTROLM 
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Section 4: Customizing and Administering CONTROL-D and CONTROL-V 


General 


This section describes the initialization and customization features that are available for 


CONTROL-D and CONTROL-V. 


CONTROL-D and CONTROIJ-V share the same customization features, except the IOA Archive 


Server (which is a CONTROL-V feature), and: the migration mission (which: is a CONTROL-V 


feature). Whenever the text refers to CONTROL-D, the same customization methods apply to 


CONTROI:r V. 


Activating the CONTROL-D Monitor 


CONTROL-D and CONTROL-V share the same monitol' when1 both p11oducts are installed. 


The CONTROL-D monito11 usually operates 24 hours a day as a started task (STC) in one 
and only one computer at an1 installation. Generally, the monitor is automatically 
activated as part of the IPL pl'ocess. To activate the monitor manually, specify the 
operator command: 


S CON'l'ROLD 


If the monitor is successfully activated, the following message appears on: the operator 
console: 
· 


CTDlOOX CONTROL-D MONITOR STARTED 


If you try to activate mo11e than1 one CONTROL-D monito11 with the same database in the 
same computer environment, the second monito11 immediately shuts down and an 
appropriate message is issued. 


Note 
See ''Activating More Than One Monitor" in the CONTROL-D Installation 
Considerations section in the JOA Installation Guide. 


The Printers Control monitor also operates 24 hours a day, but is activated and controlled 
by the main CONTROL-D monitor. When the Printers Control monito11 is successfully 
activated, the following message appears on, the operator console: 


CTD775J: monito~-name CONTROL-D PRINTERS CON'l'ROL MONITOR STARTED 


Activating Generic Processing 


When the CONTROL-D monitol' is bl'ought up, Generic Classes pl'ocessing is automatically 
activated:. You may need, to activate Generic Classes processing manually after 


CONTROL-Dis brought up. Caution should be used if you manually activate the Generic 
Option when it has not been: activated automatically. 


To manually automate Generic Classes processing, enter the ope11ator command: 


F CONTROLD,STARTGEN 


The following message appears on: the operator console from which the modify command 
has been issued: 


CTD139I GENERIC JOB DECOLLATJ:ON XS ACTJ:VE ON CLASSES (class-list) 
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Activating the Compressed Dataset Access Method 


The Compressed Dataset Access Method: (CDAM) should operate 24 hours a day because 


CDAMis used both by the CONTROL-D monitor and by jobs within the system to read, write 
and' view compressed reports. Fol' information about how a job· can: invoke the Compressed 
Dataset Access Method> refer to,Section 5 in the CONTROL-D User Manual, 


Usually, CDAM is automatically initialized as pa11t of the IPL p11ocess. To activate the 
Compressed Dataset Access Method manually, use the operato11 commandc 


S :rOAS:CNJ;T,OPTIONS=D 


If CDAM. is successfully initialized~ the following message appears on the operator console: 


C'l'M227:C IQA SUBSYSTEM "subsystem-name" :rN:IT:rALIZATION OF CONTROL-D FUNCT:CONS COMPLETED 


Modifying the CONTROL-D Sleeping Interval 


CONTROL-D "wakes up" every few seconds and checks what it has to do. This interval is 
set via a CONTROL-D installation parameter and can' be changed by the system 
administrator. In addition~ the·interval can be altered by the operator command: 


F CONTROLD,:rNTERVAL=xx 


where xx represents the interval in1 seconds. 


It is recommended that the interval be modified, by automatic commands invoked by the 


CONTROL-0 or CONTROL-M monitor (if present) according to set conditions and time 
ranges, and not manually by the operator. For sites which do' not use the CONTROL-M 


Production, Control1 System> the commands can be issued, via the JES Automatic Commands 
facility. 


At most sites, the interval' should be longer during the day (when fewer batch production 
jobs are executing) and, shorter during the night. 


The optimal' sleeping interval: depends on the processing power of the machine. Depending 
on the processing power of the machine indicated, the sleeping interval should usually not 
be less than1 the number of seconds indicated: 


• For machines with less than 20 MIPS 
10 seconds 


• For machines with 20~50 ·MIPS 
5-6seconds 


• For machines with over 50 MIPS 
4seconds 


There is no· practical benefit in setting the interval to less than these minimums. Doing so 
could slow down1 CONTROL-D operation'. 


When. the modification' is received by CONTROL-D, the following message is displayed on 
the operator console from which the modify command was issued: 


CTD123I CONTROL-D INTERVAL :rs SET TO nn SECONDS 
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Reloading the Recipient Tree 


The Recipient Tree resides in a partitioned dataset. It is loaded when the CONTROL-D 
monito11 is sta11ted. If you want to replace the current copy of the Recipient Tree in the 


CONTROL-D monitor, type the following operator command: 


F CONTROLD1LOAD'l'REE 


Notice the messages which are sent to the operator console. The following message 
signifies that the tree was loaded successfully: 


CTD160~ CONTROL-D RECXPXENT TREE LOADED- :mmnnn RECXPXENTS 


where nnnnnn' is the number of recipients successfully loaded. 


Loading the Recipient Tree Into the JOA Online Monitor 


The recipient tree is also loaded into the IOA Online monito11. 


If you wish, to load a new (modified) Recipient Tree under the IOA Online monitor, enter 
the following operator command: 


F ZOAOMONx,LOAD'l'REE 


where xis the unique monitor ID. 


If the tree is loaded successfully, the following message is displayed on the operator 
console fromwhichthe modify command was issued:. 


CTM786Z monitor-name NEW TREE LOADED. NEW. USERS WZLL BE SZGNED ON TO THE NEW TREE 


Watch the console for error messages while loading the Recipient Tree. Notify the IOA 


administrator in case of erro11s. 


When a new Recipient Tree is loaded, every user who enters the CONTROL-D User screen 
will start working with the new tree. However, users who were using the Online facility 
when, the new tree was loaded will continue to use the old tree. The old tree is deleted from 


memory after all users who were accessing it have exited, the Online facility. 


Reloading the Manual Conditions File 


The Manual Conditions file (screen 7) is created by utility IOALDNRS. A full description ofi 


this utility and its parameters is in Section 9 of this guide. This utility scans the Active 
Missions file and builds a list ofi all the p11erequisite conditions that should be set manually. 


The Manual Conditions file is refreshed (i.e., recreated) by each run of utility IOALDNRS. 


Normally, the utility is activated as the second step of the CTDNDAY p11ocedure. However, 
the utility can be run more than' once a day if desired. 
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Activating the IOA Archive Server (CONTROL-V) 


To activate the IOA Archive Server issue the following command: 


s. J:OASMON 


·Note 
The JOA Archive Server uses cross-memory·services to communicate with other address 
space requesting services. Like other address spaces using cross-memory services, 
whenever the JOA Archive Server is shut down, the address space entry in the MVS 


Address Space Vector Table (ASVT) remains non-reusable until the next IPL, and the 
message IEF352I is issued (in some MVS releases). If the JOA Archive Server is 
brought up and down many times, the ASVT may become full. New address spaces will 
not start, and an immediate IPL may be required~ 


To prevent this problem,. specify a large enough value in MVS initialization parameters 


MAXUSER, RSVSTRT and RSVNONR in member IEASYSXX in the SYSl.PARMLIB 
library. 


Information about these parameters can be found in the "MVS Initialization and 
Tuning Reference" manual. 


Deactivating the CONTROL-D Monitor 


To shut downi the CONTROL-D monitor, use following operato11 command: 


P CON'l'ROLD 


After a few seconds (a maximumi of: a minute), the monitor shuts down and the following 
messages appear on the operato11 console: 


C'l'D107:r SHU'l' DOWN UPON REQUES'l' FROM OPERA'l'OR 


C'l'D136:r S'l'OPPJ:NG 'l'BE PR:IN'l'ERS CON'l'ROL MONJ:'l'OR monitor-name 


C'l'D779I monitor-name CON'l'ROL-D PRJ:N'l'ERS CON'l'ROL MONJ:'l'OR ENDED 


C'l'D120:r CON'l'ROL-D MONI'l'OR SHU'l"l'ING DOWN 


Message CTD779I' is highlighted. Message CTD 1201 


1 is highlighted and unrollable. 


In case of: emergency, the CONTROL-D monitor can be canceled. However, this is not 
recommended'. If the monitor is canceled, the Printers Control1 monito11(s) and the 
secondary monito11s should also be canceled. 


When you shut down the CONTROL-D monito11, all other CONTROL-D facilities (the 


Comp11essed Dataset Access Method, IOA Online monitors, IOA Archive Server) and every 
Online facility session' can remain active. 


Deactivating Generic Processing 


It is sometimes desi11able to stop CONTROL-D fromi processing the outputs in the generic 
classes (usually to replace the current repo11t decollating mission definitions). 


Enter the operato11 command1: 


F CON'l'ROLD,S'l'OPGEN 
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The following message is displayed on the operator console from which the modify 
command was issued: 


CTD140~ GENERIC JOB DECOLLATJ:ON J:S BEING DEACT:CVATED 


New decollation of generic class output does not start. Currently executing (decollating) 
missions finishes processing those jobs whose output processing already started. 


Automatic Warning 


When generic decollation is deactivated, the CONTROL-D monitor issues the following 
warning on the operator console: 


CTD271J: GENERIC JOBDECOLLATJ:ON J:S J:NACTJ:VE - 
CHECK WHY 


This message is highlighted) and reappears every ten minutes if there is a job waiting to 
be decollated in one of the generic classes. 


Generic mission deactivation can occur in1 one· of the following ways: 


• If started task CTDNDAY fails during the ovdering of a generic decollating m1ss1on, 
deactivation is automatic. Check if all the generic· decollating missions ave in the Active 
Missions file befove reactivating generic processing. 


• The operatov issues the STOPGEN command (discussed. above). Check why generic 
decollating was deactivated and whether it should remain deactivated~ 


• The Active User Report List file becomes fulll Run utility CTDDEI:,RP to,delete unnecessary 
entries from this file. 
The spool, can become full if there are many generic jobs waiting to· be decollated. 


Deactivating the Compressed Dataset Access Method 


There is ravely any reason to deactivate the Compressed Dataset Access Method, It should 
be done only in conjunction, with problem-soliving efforts as directed by your IOA 


repvesentative. Shut down the CONTROL-D monitol' and issue the operator command: 


S J:OASTERM,OPTJ:ONS=D 


The following message is displayed on the operator console: 


CTM231J: J:OA SUBSYSTEM "subsystem-name" DEACT:CVATJ:ON OF CONTROL-DFUNCTJ:ONS 
COMPLETED• 


If the same subsystem supports other IOA pvoducts, their functions remain active. 


Deactivating the IOA Archive Server (CONTROL-V) 


To deactivate the IOA Archive Server, use one of the following operatol' commands: 


P 
J:OASMON 


or 


F 
J:OASMON,STOP 


When either of these commands is issued, the IOA Archive Server terminates and an 
appropl'iate message is displayed on' the operator console. 


IOA107I IOASMON - 
SHUT DOWN UPON REQUEST FROM OPERATOR 


IOA10BJ: J:OASMON - 
J:OA ARCHIVE SERVER SHUTTING DOWN 
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New Day Processing 


Overview 


The CONTROL-D monito11 is usually activated as a started task and; remains active 24 


hours a day. New Day p11ocessing consists of automatic cleanup from the previous day's 


mission ordering and automatic oJJdering 0£ missions for the current day. 


The main components related to· New Day processing are: 


• New Day procedure 


• User Daily job1 


• Date Control records 


• Active Missions file 


Starting the New Day Procedure 


Once a day, at a predefined time determined by the JOA system administrato11, the 


CONTROL-D 011 CONTROL-V monito11 and the Printers Control' monito11 a11e shut down 
and New Day procedure CTDNDAY (this name is defined in the installation 
1 parameters 
and may be different at your site) is activated. The following highlighted, unirollable 


messages are sent to the operato11's console: 


CTD779:C monitor-name CON'1'ROL-DPR:CN'1'ERS CON'1'ROLMON:ITOR ENDED· 


CTD113W CON'1'ROL-D MON:ITOR SHUTTING DOWN FOR A NEW DAY 


The CONTROL-D monito11 signals the Printers Control monito:v to shut down and waits 
until it does so. Then the CONTROL-D monitor shuts itself down. When' the Printers 


Control 
1 monito11 shuts down, it suspends all active printing missions. Printing resumes 
after the Printers Control monito11 is restarted~ 


Before CONTROL-D shuts down, started task CTDNDAY is activated. This started task 
can ask the operator several questions. After a few minutes CTDNDAY finishes executing 
and automatically reactivates CONTROL-Dusing the following command: 


S CON'1'ROLD 


If CTDNDAY abends or fails for any reason, a highlighted, unrollable message is issued to 
the operato11 console and the monito:v is not reactivated automatically. 


CTDNDAY compares the date and time of the computer with the CONTROL-D control 
files. If they do not match\ the following questions are displayed on the operato!' console: 


CTD426W CONTROL-D (CTDNDAY) D:ID NOT RUN FOR nnnnnn DAYS 


CTD427W :IS TH:IS TRUE? (ANSWER ''YEs" OR ''No") 


CTD428W YOUR ANSWER :IS: 
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This situation may occur after the computer has not been working for a few days (e.g.,. a 
hardware failure or a holiday) in which case the response should be YES. If this is not the 
case, the computer was probably IPLed with the wrong date. In this case the response 
should be NO, the date on the computer should be checked and corrected, and CTDNDAY 
should be restarted. If the date on1 the computer is correct, the IOA system administrator 
should, be called to check the cause of the plloblem. 


New Day Procedure - Workflow 


The New Day procedure performs the foll()wing daily maintenance actions and then 
reactivates the CONTROL-D monitor: 


1. Cleans unnecessary missions from the Active Missions file. This includes missions that 
ended OK, missions in 
1 wait schedule state whose MAXW AIT parameter has been exceeded, 
emergency missions which we no:longer needed, etc. 


Note 
Missions that ended OK before the time specified in parameter MAXWAIT was 
reached, can optionally· be kept in the Active Missions file until the MAXW AIT period 
is exceeded for these missions. 


2. Schedules regular and generic decollating missions, printing missions, backup missions, 
restore missions, and CONTROL-V migration: missions. See "Mission Scheduling" later in, 
this section foll more information~ 


3: Reactivates the CONTROL-D monitor by issuing the operator command S CONTROLD. 


4. Updates the IOA Manual Conditions file. See the. description of utility IOALDNRS in 


Section 9 of this guide. 


User Daily Job 


The User Daily job is used: to place new missions in the Active Missions file. Each User Daily 
job usually runs once a day on one or more missions definition members. The missions are 
selected according to the wo11king date specified to the User Daily job, The11efo11e, the User 
Daily job is date-dependent, and certain special situations must be dealt with, such as: 


• The computer has not been wo11king for a few days (e.g., due to holidays, or a 
hwdware/software failure). 


• The user wants to run a job or a group of jobs and to process their reports prior to or later 
than, the current working date. 


Date Control Record 


Each User Daily job uses a special Date Control record to sto11e the last running date for 
the User Daily job: A Date Control record is a member in the CONTROL-D PARM lib11ary 


in, which relevant date information, is placed during New Day processing. 
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The Date Control reco:rid is analyzed, by the User Daily job, to determine the current 
running date, the last running date, and possible error situations. This date information is 
used to manage the ordering of missions during New Day p11ocessing. 


When, a User Daily job is runi the current working date is placed in the Date Control 


record, and the Basic Scheduling parameters of each mission in the mission lists being 
ordered are compared to· this date to· determine if the mission should be placed' in the 
Active Missions file. 


A Date Control reco:rid is 80 characters in, length, and contains the following fields: 


Columns 


1-6 


8-13 


15-20 


22-27 


29-34 


36-41 


42~47 


48-53 


54-59 


67-72 


Value Added 


date-1 


date-2 


date-3 


date-4 


date-5 


date-6 


date-7 


date-8 


date-9 


date-10 


Current (011 last) original scheduling date. 


Cuvrent (011 last) original, scheduling date of non-generic 


repo:vt decollating missions. 


Current (011 last) original1 scheduling date of non-generic 


repo:vt decollating missions finish indicator. 


Cuvrent (011 last) original, scheduling date 0:£ printing 
missions. 


Cuvrent (or last) original' scheduling date of printing 
missions finish indicator. 


Current (or last) original scheduling date of backup 
missions/migration missions. 


Cuuent (011 last) original scheduling date of backup 
missions/migration, missions finish indicator. 


Current (or last) original scheduling date of restore 
missions. 


Cuvrent (or last) original scheduling date of restore 
missions finish, indicator. 


Finish indicator date of the User Daily job, 


Date format is mmddyy, ddmmyy 011 yymmdd, depending on the site standard. 


Use of the Date Control Record by the User Daily Job 


In certain' cases, it is possible to manually update the Date Control reco11d of a User Daily 
job via a regular editor. The Date Control record is referenced by DD statement DACH:K 


(in, the Daily procedure 011 CLIST). 


The work flow of the User Daily job is dependent on the Date Control reco11d. The main 
steps of the User Daily job are: 


• Checking the last running date of the User Daily job (the intemal1 program CTDCHK). 


The :fi.11st date in: the Date Controlreco11d(column 1-6) is compa11ed to the cuvrent installation 
working date (at the time of the run). If they match the User Daily job has already run, 
today, a message is issued, and the condition code is set to 0004. 
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If the current installation working date is earlier than the first date of the Date Control 
record, a run of the User Daily job has been attempted before its time. The User Daily job 
stops executing and notifies the user accordingly. 


If the current installation working date is later than the first date ofi the Date Control record 
(the normal' situation), the first date of the Date Control record (columns 1-6) is 
automatically updated to the current installation working date. This date is then used by aU 


components of the User Daily job as the current scheduling date. 


If the User Daily job has not run• for more than' one day, a warning message is issued and 
the User Daily job tries to schedule the missions for all ofi the days which have passed since 
the last scheduling date (according to the production parameters). 


• Placing missions in the Active Missions file acco11ding to the current scheduling date and the 
last running date (via internal p11ograms CTDRRQ, CTDPRQ, CTDBRQ, and CTDSRQ). See 


the table in, "Programs Called During New Day Processing" for mo11e information. 


Program' CTDxRQ wo11ks on mission definitions referenced by DD statement DAxxxLST. Fo11 


each catego:riy in the mission, the program checks whether the catego:riy should be scheduled 
on one 011 all the days that have passed since the last original' scheduling date (date-2, 
date-4, date-6 or date-8) until, the wo11king date in 
1 the record, (date-1). If the mission· should 
be scheduled, the mission is placed in' the Active Missions file. 


For example, if a computer did not operate from the 20th to the 23rd of the month, a mission 
originally scheduled to execute on, the 20th is not executed~ It is the function of program' 
CTDxRQ to decide whether or not the mission should be retroactively scheduled to run on 
the logical date of the 20th (see parameter RETRO in Sections 3 · and 4 of the CONTROL-D 
User Manual~. 


Note 
Basic Scheduling parameters are considered only if the FORCE option is not 
specified. 


When the program finishes processing the mission definitions, the finish indicator dates 
(date-3, date-5, date-7 and date-9) are updated to the wo11king date calculated by program 


CTDCHK (date-1). 


Before a CTDxRQ program starts operating, it compares date-2' with date-3 (date-4 with 
date-5, ek). If doinot match, a previous run of the CTDxRQ p11ogram1ofthe same User Daily 
job has probably abended. The user is notified and the program1 terminates. To correct the 


erro11, you must modify the user Date Control reco1d to the correct date values (using a 
standard editor). 


Note 
When manually modifying the Date Control record, make sure that the same 
missions are not scheduled to run twice on the same day. 


• Indicating that the User Daily job has ended (via program CTilPDA). 


Program CTDPDA updates the finish indicator date. (date-10) by setting it to the running 
date (date-1). This indicates that the User Daily job finished, successfully. 
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Use of the Date Control Record by the New Day Procedure 


The CONTROL-D New Day p11ocedu11e uses its own Date Control, reco11d. This Date Control 
record differs from the User Daily job's Date Control reco11d in that it has two additional 
dates: date-11 and date-12. 


Columns 


60-65 


74-79 


Value Added 


date-11 


date-12 


The last formatting date 0£ the Active Missions file (used 
by the program 
CTDFRM~ is requi11ed to, prevent 


fol'matting from being performed twice on the same day. 
When this date is in the record, the program' CTDCHK 


recognizes that this is a Generali Date Control reco11d, If 
there are problems concerning the· date, the program 
prompts the operator with a series of questions. 


The current original 
scheduling date 
of Generic 
decollating missions. 


When' wo11king under the New Day p11ocedu11e (CTDNDAY), the program asks the operator 
a question, regarding the computer's current date. This is to ensure that an incorrect date 
was not inadvertently ente11ed during the !PI:. p11ocess. 


Programs Called During New Day Processing 


Two impo11tant p11ograms in New Day Processing are CTDlLY and CTI:>ILU. 


• The New Day procedure executes program CTDILY. 


• Each User Daily job executes p11ogram1CTDILU. 


Programs CTDILY and CTDILU are very similar. Both execute other p11ograms which 


implement New Day p11ocessing. However, p11ogram1 CTDILU (used by User Daily jobs) has less 
authorization (i.e., is not APF-authorized) and1 calls fewer programs than program CTDILY. 


Both CTDILY and CTDILU read the member refe11enced. by DD statement DAPRO©, and 
activate the p11ograms listed in1 the member. 


The format fo11 each reco11d in the p11ogram list is: 


Columns 


01-08 
Program1name. 


10-11 
Maximum condition, code allowable in the preceding program . .lf a higher 
conditionicode is encounteredinthe precedingprogram,.the current program is 
not executed. 


The p11ograms called by the p11ogrami CTDILY (called by the New Day p11ocedure) and by 
program CTDlLU (User Daily jobs) ave shown in the following chart: 


4-10 
IOA Rel. 5.0;0 Administrator Guide 


(_) 


Section 4: Customizing and Administering CONTROL-D and CONTROL-V 


CTDFRM 


CTDCATF 
./ 


CTDPRQ 


CTDBRQ 
./ 
./ 


CTDSRQ 
./ 
./ 


CTDGRQ 
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Checks the current date and its relation to· the General 
Date Control' record (see above). The program may 
communicate with the computer operato11 to verify that 


CONTROb-D is activated on the coMect date. 


Program 
1 reformats the Active Missions file. Missions 
that have already executed and ended OK, missions 
whose MAXWAIT pwameter has been exceeded, or 
emergency missions which we not needed, are erased 
from the file and' the file is compressed,. If this program 
abends, it recovers automatically after startup, using an 
automatically-generated 
backup 
copy. 
See 
also 


"Parameters of the New Day Procedure." 


Reformats the Active Transfer file. Packets that have 
already 
transferred 
successfully, 
packets 
whose 
MAXW AIT parameter has been exceededi and the 
coNesponding files fo11 these packets are erased from 


the Active Transfer file. The file is then compressed. If 
this program abends, it recovers automatically after 
startup, using an automatically-generated backup copy. 


Places printing missions in the Active Missions file 
according to· the date in the General Date Control 
reco11d and the scheduling criteria in the supplied 
printing mission definitions. The program receives 


pwameters via DD statement DAPRTl.ST. 


Places backup and migration missions in the Active 
Missions file acco11ding to the date in the General Date 
Control' record and the scheduling criteria in the 
supplied backup mission and migration mission 
definitions. The program receives parameters via DD 
statement DABKPLST. 


Places resto11e missions in the Active Missions file 
according to. the date in' the General Date Control' 


reco11d and the scheduling criteria in the supplied 


resto11e mission 1 definitions.. The program receives 
parameters via DD statement DARSTLST. 


Places generic decollating missions in the Active 
Missions file according to the date in the General Date 


Control reco11d and the scheduling criteria in the 
supplied, generic decollating mission definitions. The 


p11ogram1 receives parameters via DD 
statement 


DAGENLST. 
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CTD34F 


CTDPDA 
./ 


Places non-generic decollating missions in the Active 
Missions file according to· the date in the General Date 


Control1 reco11d and the scheduling criteria in the 
supplied report decollating mission, definition. The 


p11ogram 
receives parameters via DD 
statement 


DAREPCST. 


Executes operator commands (system~ JES, VTAM, etc.) 


from a list (ddname DA34F). The default command is S 
CONTROl!,D which starts the CONTROL-D monitor. 


Records the end, of the Daily run • 


Parameters of the New Day Procedure 


Program CTDFRM, activated as part of the New Day p11ocedure, is responsible (among other 
duties) fo11 erasing all CONTROL-D related: conditions from the IOA Conditions/Resources file 


fo11 the cu11rent day. Pre11equisite conditions are always assigned' a date reference (day and 
month). They can be kept in1the IOA Conditions/Resources file fo11 a entil'le year. Therefore, it is 


necessacy to erase them at the beginning of each working day. Otherwise, missions may be 
triggered because of conditions remaining from the previous year. 


It is common to,use prerequisite conditions which are not date-dependent (e.g., IMS-IS-UP, 


or .ARrFILE-OK). It is important that these conditions not be erased, You can supply a list of 
conditions which are not to be erased via DID statement DAFRMJ:N. The valid format is: 


IGNORE COND prefix 


Where 


prefix 
Name (011 mask) of conditions not to be erased. If an1 asterisk (*) is 


specifiedi no conditions we erased, Multiple IGNORE statements can be 


specified, 


Note 
When the CONTROL-M Production Control System is installed at your site the above 
mentioned updates of the IOA Conditions I Resources file are performed by 


CONTROL-M. 
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Mission Scheduling 


Overview 


CONTROL-D and CONTROL-V manage report distribution at your site via m1ss10ns 
defined by the user. Several different types of missions are available, each for a different 
type of task. 


• Decollation, missions 


• Printing missions 


• Resto:r:e missions 


• Backup missions 


• Migration missions (CONTROI!.-Vonly) 


The following pages explain how to manage missions for the topics:. 


• Scheduling- General(anoverview of the basic mission scheduling options) 


• Using the New Day Procedure (CTDNDAY) to Schedule Missions 


- 
Supplied Mission, List Members 


• Using a User Daily Procedlllle to Schedule Missions 


• Scheduling a Mission Manually 


• Scheduling Missions - Work.flow 


Following these topics is a description of special considerations for each mission type. 


Scheduling - General 


Missions can be scheduled via the following methods: 


• Automatically by the CONTROI:.-D New Day procedure (CTDNDAY). This is the usual 


method, (See "Using Procedu11e CTDNDAY to Schedule Missions".) 


• Using a batch job. (e.g., procedu11e CTDRPDAY fo11 decollating missions). The job can be 
submitted manually ox: automaticall~ by a scheduler. (See "Using a User Daily Job to 


Schedule Missions".) 


• Manually from the Mission Definition screen, using the 0 (Orde11) and F (Force) options. 
This is the most convenient manual method~ 


• Manually under !SPF using the Online Utilities PaneL The panel can be invoked directly 
using a CLIST (e.g~, CTDMISRQ MIS(REP) for a decollating mission). 


• Manually under ROSCOE (e.g., using RPF CTDRQPRT for a printing mission). 


• Using a KeyStroke Language utility found in the SAMPI:,E library (e.g., BKPORDER for 
backup missions) .. 
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Using the New Day Procedure (CTDNDAY) to Schedule 


Missions 


This is the recommended method for scheduling missions because the New Day procedure 
is activated automatically once a day. A member in the CONTROL-D PARM library is 
referenced' by a DD statement in the New Day procedulle. This member contains a list of 
missions that should be scheduled. The Basic Scheduling parameters of these missions are 
analyzed, against the requested scheduling date. If the mission should be scheduled for 
that day, it is placed' on, the Active Missions file .. The table contains the names of the 


mission list members, and the DB statements used, to reference each mission type in the 
New Day procedul'e. 


Regular Decollating 
REP LIST 
DAREPLST 


Generic Decollating 
GENLIST 
DAGENLST 


Printing 
PRTUST 
DAPRTLST 


Restore 
RSTLIST 
DARSTLST 


Backup, 
BKPLIST 
DABKPLST 


Migration 
BKPLIST 
DABKPLST 


Each line in the member containing the list ofi missions has the following format: 


date libname [missionname catname] [FORCE] 


date 


lib name 
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ODATE (original' scheduling date) ofi the mission, 


Validformats are: 


mmddyy, ddmmyy 011 yymmdd (depending on the site standard) 


The Basic Scheduling parameters of the mission, are compared with this 
date .. The· Date Control 
1 record is not updated~ 


* (asterisk) can, be specified to indicate that date management be handled 
automatically by CONTROI1-D using the Date Control record~ Parameter 


RETRO affects the result obtained when' the mission's basic scheduling 
criteria are compa11ed with the last scheduling date ofi the mission. 


Name of the library in which the mission1 parameters are found. 


Valid values are: 


• Specific lib11ary name. In: this case, the library is dynamically allocated; 


• A DD name p11eceded by an asterisk. The library must be a partitioned 
dataset with a record length of 80: 
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Name of the mission (a member in the lib11ary). Optional~ 


* (asterisk) can be specified to indicate that all the missions (members) in 
the specified library are analyzed. Use of an asterisk eliminates the need 
to update mission lists to include new missions .. 


The specific category of the mission is analyzed. If an asterisk is specified, 
all categollies of the mission are analyzed. 


Optional pwameter. When FORCE is not specified, the Basic Scheduling 


pa11ameters of the category of the missions are analyzed against the 
specified olliginal scheduling date. If the mission should be scheduled on 
that date, it is placed on the Active Missions file. 


When FORCE is specified, mission, categories are placed on the Active 
Missions file with the specified original scheduling date (which must be 
an actual date, not an asterisk) regardless of basic scheduling criteria. 


The following is an example of the JCL (relevant DD statements of procedure CTDNDAY 
only): 


//C'l'DNDAY 


//DACHK 


//DAREPLS'l' 


EXEC 
PGM=C'l'DILY 


DD 
DISP=SHR,DSN=ctd_parm_library(DDA'l'EREC) 


DD· 
DISP=SHR:,.DSN=ctd_parm_library(REPLIS'l') 


The Date Control record used, in this case is the General CONTROL-D Date Control 
record. 


Supplied Mission List Members 


The following are the default mission list members supplied with CONTROL-D: 


PRTLIST 


BKPUST 


RSTLIST 


Schedules one printing mission' (for form STD). 


Schedules the following backup missions: 


BKP0007D 


BKP0031D 


BKP0180ID 


BKP0365D 


Back up for 7 days. 


Back up for 31 days. 


Back up for 180 days. 


Back up for 365 days. 


Schedules the following resto11e missions: 


RST0060M 
Restore reports every 60 minutes 


RSTADHOC 
Restore reports immediately (for authollized users only) 


Note 
Generic Decollating Missions 


It is recommended to schedule Generic Decollating missions by the New Day procedure. 


See "Decollating Mission Management" later in this·section. 
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Using a User Daily Procedure to Schedule Missions 


The following JCL should, be used:: 
II 
EXEC 
procedure-name 


/IDAC'HK 
DD' 
DISP=SHR, DSN=ctd_parm_library { daterec) 


llDAxxxLST 
DD 
DISP=SHR1DSN=ctd_parm_library{mlistmem) 


Where: 


procedure-name 


DAxxxLST 


daterec 


mlistmemi 


CTDRPDAY should be specified, for decollating missions. 


CTDPRDAY should be specified for printing missions. 


CTDRSIJ>AY should, be specified for restore missions. 


CTDBKDAY should be specified for backup and migration missions. 


Reference to· the member containing the mission list. Same as specified 
above for the New Day procedure. 


Name 0£ the Date Control record for the procedure. 


Each procedure must use one Date Control record; A Date Control' record 
cannot be shared by two, procedur:es. The Date Control record is 
referenced by DD statement DACHK and is used to· determine the col'!rect 


scheduling date for selecting missions accor:ding to their scheduling 


criteria• See the description of the Date Control, record earlier in this 
section for mor:e information. 


Name of the member containing the mission list. Same as specified above 
for the New Day procedure. 


Scheduling a Mission Manually 


Missions are normally scheduled automatically via the New Day processing. However, it is 
sometimes necessary to schedule a mission manually (for testing, ad hoc missions, etc.). In 
addition, it may be necessary to schedule a mission, for different scheduling dates (e.g., 
scheduling a mission: which was to run: on the 1st of next month on the 30th 0£ this month, 


OJI rescheduling a mission which ran on the 4th because the entire run has to be performed 
again on the 5th). 


The recommended method of manually scheduling a mission is using the 0 (Order) OJI F 
(Force) options of the Mission List screen or via an ISPF online utility. However, if you 
wish to schedule a mission: without entering the IOA Online facility, use one of the 
following CLISTs, KSL utilities or RPFs (for ROS00E): 


Decollating 
(Regular: CTDMISRQ MIS (REF) 
CTDRQREP 
REPORDER 


and Generic) 


Printing 
CTDMISRQ MIS (PRT) 
CTDRQPRT 
PRTORDER 
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Restore 
CTDMISRQ MIS (RST) 
CTDRQRST 
RSTORDER 


Backup 
CTDMISRQ MIS (BKP) 
CTDRQBKP 
BKPORDER 


Migration 
CTDMISRQ MIS (MIG) 
CTVRQMIG 
MI GORDER 


See Section 2 of the CONTROL-D User Manual for more information about ISPF Online 
utilities. 


Scheduling Missions -Workflow 


A mission' is defined using the Online facility (option R or M). Each m1ss10n contains 
parameters describing actions to be performed, and when and, under what conditions they are 
to be perfo11med. Mission defmitions are stored in regular libraries (partitioned datasets). 


Mission definitions in the library are not active instructions to the CONTROL-D monitor. 
To make a mission, active, it must be placed on the Active Missions file. The process of 
selecting a mission, from the definition lib:vary and placing it on the Active Missions file is 
performed by the CONTROL-D New Day procedure during New Day processing. 


When invoked, the New Day procedure analyzes definitions of missions in a libra11y. 
Acco11ding to the basic scheduling criteria specified, approp:viate missions are selected and 
placed in the Active Missions file. Each mission is automatically assigned an original 
scheduling date (ODATE) when it is placed in: the Active Missions file. 


Decollatlng Missions 
JOBA 


Library 
JOBB 


Printing Missions 
Mission C 


Library 
Mission D 


Backup Missions 
Mission E 
Library 


Restore Missions 
Mission F 
Ubrary 


Migration Missions 
MissionG 
Library 


Date Control Parameters 


New Day 
Procedure 


Execution' 
Messages 


IOALog 


CONTROL-D 


Active Missions File 


Printing Mission C 


Printing Mission D' 


Backup Mission E 


Restore Mission F 


Migration Mission G 


When a decision is made to schedule a mission, its parameters are passed to CONTROL-D 


exit CTDX001. This exit can modify the contents of the parameters or cancel the mission. 
If the mission is not canceled by the exit, the mission is placed in, the CONTROL-D Active 
Missions file. 
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CONTROL-D 


Missions 
f-----.i>< 


Library 


CONTROL-D 
>----- 
AGtive 


Missions 


File 


The Active Missions file can contain more than, one mission: with the same name. 


Examples 


• Several categories of the same printing missionc Consider the organization, of bundling by a 
delivery network. A few categories are used, each category describing a bundle with 
different report recipients.. The categories COURIER-NORTH, COURIER-SOBTH, 
COBRIER-AIRPORT are used for the same printing mission, A different list of recipients 
are bundled under each category. Using this method, asepwate bundle is prepared for each 
delivery facility (e.g., COURIER). 


Printing 


Missions 


Active Missions File 


• A printing mission' is late by more than one day (e.g.,. prerequisite reports have not yet 
finished). In this case, the Active Missions file contains two printing missions with the same 
name, but eachwith adifferent original1scheduling date. 


• When a daily job is late by more than, one day (e.g., input tape has not arrived yet). In this 
case, the Active Missions file contains two report decollating missions for the same job, each 
with a different original scheduling date .. 
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• When the same job is being run a few times a day. 


Note 


Report 
Decollating 
Missions 


Active Missions File 


Joe . a 090996 


Scheduling of decollating missions can be made dependent on the operation mode of 
the production control system at your site. It is possible to use all the different modes of 
operation at the same site. This is usually done to solve special scheduling problems. 


The different modes of operation generally vary according to the type of production 
control system in use. The following situations are possible,· 


• The production control system is CONTROL-M. 
• The production control system is not CONTROb-M. 
• There is noproduction control system. 


See "CONTROL-D and Production Control System Scheduling Work Flow" later in 
this section for a description of how CONTROb-D interacts with production control 
systems. 


Decollation Mission Management 


Overview 


Regular report decollating m1ss10ns can handle output from the spool or from CDAM 
datasets. They are executed once to handle the output produced by a specific job name 
(unless defined as cyclic repol't decollating missions, with a task type of CRP). 


Generic Decollating Missions 


CONTROb-D pl'ovides the option of decollating output from dedicated output classes. 
Whenever a non-held output appears on the spool1 in one of the classes defined for generic 
processing, the CONTROL-D monitol' looks for a generic decollating mission which matches 
the job name, CLASS, DEST, FORM, and EXTWTR o~ the selected SYSOUT. The search is 


perfo:r~med on all generic missions currently in, the Active Missions file (which a11e not held). 
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Generic decollation1 is intended for processing ad hoc sysouts (e.g., MSGCLASS), or reports 
generated' dynamically fromi a CICS (011 similar) environment .. A generic·decollating mission 


can, process sysouts fromi a job which is still running (e.g., SYSLOG files) at time of 
decollation. 


Generic Decollating Mission Work:flow 


A generic decollating mission can, be defined for a specific job name but is usually used in 
conjunction' with a generic job name. A generic job name is specified using mask 
characters .. Execution of the generic decollating mission is triggered by the appearance of a 
job 1 (whose name matches the job name mask) in a specific output class (in non~held 


status). These output classes are defined in the CONTROL-D installation parameters .. The 
appearance of a matchingjob name in other output classes (011 in held status in the generic 


classes) does not trigger the execution, of a generic decollating mission' 


A generic decollating mission' can, decollate only fromi the generic classes defined in the 
CONTROL-D installation pa11amete11s .. Any output which is decollated, by a generic 
decollating mission is purged, fromi spool.. After decollation1 the mission's post-p11ocessing 
pa11ameters (OUT, SHOUT) are executed, but the mission does not stay in ENDED status. 
It is recycled for re-execution (i.e., it is in WAIT SCHEDULE status). 


All runtime scheduling criteria (IN, TIME, PRIORITY) are applicable to generic decollating 
missions. Usually the recycled generic missioni is immediately eligible fo11 execution and is 
assigned the WAITING FOR JOB status. 


Sysouts of jobs that appear on a generic class but do not have a matching generic 
decollating mission name in, the Active Missions file are removed fromi the generic class in 


one ofi the following ways, depending on the value specified in1 CONTROL-D installation 
parameter GENOTFND: 


• Values which are valid, under JES2~ 


The output's spool priority is set to one .. This allows other output with higher priority to 
be p11ocessed;. Default. 


The output is deleted fromi the spool. 


The output's spool status is altered to· hold~ preventing it fromi being processed again by 
CONTROL-D generic decollation class monitoring. 


The output's class is altered to the specified, class. This class should, not be one of the 
classes specified in1parameter GENCLAS. 


• Values which are valid under JES3: 
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The output for which there is no· associated scheduled generic decollation mission is 
deleted from the spool. 


The output's class is altered to the specified class. This class should be defined as 
HOLD=EXTWTR. This class should not be one 0£ the classes specified in1 parameter 
GEN CLAS. 
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Additional Considerations 


It is possible that more than one generic decollating mission matches the same job. In this 
case, they are p11ocessed according to their prio11ity levels. If their prior:ities are equal, they 
are processed in the or:der in which they appear in, the Active Missions file (i.e., in the 
order in which they were ordered/scheduled). 


When GENERIC=Y and MONITOR is blank, the mission is 011dered separately for each 
monitor and each copy of the mission' is assigned a different monitor number (ID). This 
enables concurrent decollating of generic jobs under more than one monitor:. 


It is also possible that a match could occur between a generic definition and a regular report 
decollating mission. This duplication should not create problems because it is impossible to 
specify a generic class in an ON CLASS statement of a regular: report decollating mission. 
However, if a regular (ON DSN) repollt decollating mission is specified with parameter WHEN 
IN QUEUE=Y, it might never execute because its job's output is deleted by a generic 
decollating mission. If WHEN IN QBEUE= Y is specified for a regular report decollating 
mission, make sure that the job's output wiU not be deleted by a generic mission. 


In an environment using a pr:oduction' control system there is a significant advantage in 
decollating job repo11ts using regular report decollating missions. The decollating of the 
reports can be made dependent on a prerequisite condition which is added by the 
production' control 
1 system after checking that the job has finished executing OK. Using 


this method, erroneous reports are not decollated. On the other hand, the MSGCLASS 


output of the job (on another class) is best handled by a generic decollating mission. 


Examples 


Generic decollating missions can be used to: 


• Handle all MSGCt.ASS outputs of: jobs in the same way (e.g., move them from spool1 to 
compressed datasets, allow Online Viewing of output; and retain backups for two weeks). 


• Handle ad hoc jobs (e.g., decollate output to users based onjob p11efix). 


Note 
CONTROL-D first handles regular report decollating missions according to their 
priority and then scans the generic output classes for outputs. However, this does not 
guarantee that the regular mission of the same job is executed before a generic one. 


Scheduling Generic Decollating Missions Via the New Day Procedure 


Special scheduling of generic decollating missions ensures that all generic missions are 
scheduled successfolly before the CONTROL-D monitor starts generic mission processing. 
If procedure CTDNDAY fails (e.g., system crash or invalid parameters in generic 
decollating mission definitions) while processing a report decollating mission from member 
GENLIST, when the CONTROL-D monitor is started, it will not pr:ocess generic decollating 
missions without a manual operator command. If all generic missions are scheduled 
successfully, decollating of generic missions resumes when the CONTROL-D monitor is 


b11ought up. 


If generic mission decollating is not active when the CONTROL-D monitor shuts down for 
a new day (e.g., because the operator deactivated it manually), it remains inactive when 
the CONTROL-D monitor is br:ought up again• 
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Generic decollating m1ss1ons can also be scheduled manually, 011 by any 0:£ the other 
scheduling methods. However, it is highly recommended not to schedule the missions via 
the REPUST member of the New: Day procedure w:ithnon-generic decollating missions. 


Controlling the Generic Process 


Youi can, control1 generic processing by turning it off and on. This pr,ocess is performed via 
operator commands. By default generic processing is started when CONTROL-D is started 
(unless it was previously deactivated by an, operato11 command). 


One reason' that generic pl'ocessing may be deactivated, is if the CONTROL-D New Day 


p11ocedure (CTDNDAY) fails to schedule the generic missions to the Active Missions file .. 


When generic· processing is deactivated, the generic missions do· not select output from the 
defined generic classes. 


Generic processing may also be deactivated if an erro11 occurs while updating the Active 


User file during decollation, In' this case generic processing is deactivated to prevent the 
deletion of sysouts from. the spool without the creation of relevant reports in the Active 


User file. 


To, stop generic processing, issue the following operato11 command: 


F CONTROLD,STOPGEN 


To·sta11t generic·p11ocessing, issue the folfowing operator command: 


F CON'l'ROLD,STARTGEN 


Defining a Generic User Name List 


CONTROL-D provides an option to specify a generic user name in the report decollation1 


definition. (See parameter D© USER in' Sectioni 3' of the CONTROL-DIV User Manual fo11 a 
detailed description,) This option1 defines a generic name that describes a group of users 
(e.g., all the branches of the bank, senior management, 011 financialicontrollers.) 


A generic user name list resides in· a PDS member. The name of the member is referenced 
in the DO USER statement, preceded by an asterisk (e.g., *BRANCHES.) The member 
must be in 1 a lib11ary which should be referenced by DD statement DAGENUSR of the User 


Daily job (or CTDNDAY.) Although, it is possible to use a few generic user name lib11aries 


in1 a distributed 
1 environment, it is generally recommended to use only one to simplify the 


administration, 


Each' member in the library repl'esents a generic user name. The contents of the member 
are lines in the following format: 


Column 


01- 05 


06- 09 


10-11 


12~31 
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Data 


TUSER (i.e., constant value TUSER) 


blank 


Level· code of the user (e.g~, recipient) as defined in the Recipient Tree. 


User name 
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One line is required for each user. Additional lines in the member are not permitted. Do 
not use columns 73-80: Each line must describe a valid user name in the Recipient Tree. 


Use the main user name, not a synonym, 


Example of the member BRANCHES: 


TUBER 
30BR101 


TUBER 
30BR103 


TU SER 
30BR106 


TUBER 
30BR11.2 


TU SER 
30BR114 


TUBER 
30BR123 


TUBER 
30BR127 


TUBER 
30BR128 


TU SER 
30BR130' 


Interfaces to Production Control Systems 


Various aspects of CONTROL-D/Production Control Systemi interfaces are explained under 
the following topics: 


• Overview of CONTRO:D.-M Scheduling With CONTROL-D 


• Scheduiing via the CONTROL-M Production Control1 Systemi 


• Scheduling via a Non-CONTROb-M Production Control System, 


Overview of CONTROL-M Scheduling With CONTROL-D 


CONTROL-M jobs are scheduled and placed in the Active Jobs file during CONTROL-M 


New Day Processing. (The job order is submitted when the runtime requirements are 
satisfied.) The main function 0£ CONTROL-M New Day Processing is to determine whether 
or not the job should be executed' on a specific day. Once that decision' is made, the job 


011der is placed in the CONTROL.-M Active Jobs file. 


The CONTROL-D catego11y field (in the CONTROL-Mjob order) is checked. If the catego11y 


field is not blank, a search is made for the report decollating mission in the lib11ary 


referenced by DD statement DAREPMIS. The search is for a member with the same name 
as the CONTROL-M MEMNAME parameter (the CONTROL-D job name), and for the 
same catego11y as specified in the CONTROL-M catego11y field 1• If category* was used, the 
search is foll all catego!lies o:Hhe specifiedjob name. 


The scheduling criteria of the CONTROL-D report decollating missions (if any) are ignored 
(unless optional wish WM0983 is applied). The report decollating missions parameters are 
passed to CONTROL-D user exit CTDXOOl. This exit may alter the contents of the 
parameters 011 cancel the decollating mission. If the report decollating mission is not 
canceled by the exit, the report decollating mission is placed in the CONTROL-D Active 
Missions file. The or:iginal1 scheduling date assigned to the report decollating mission is the 
same as that oHhe CONTROL-Mjob order. 
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C:ONTROli.-M 
Scheduling 


Tables 


CONTROli.-D 


Decollatihg. 
Missions 
Library 


Usage Instructions 


i----~ 


i------+< 


CONTROli.-M 
New Day 
Processing 


CONTROli.-D 


New Day 
Processing 


CONTROli.-M 
>-----+1 
Active 
Jobs 
File 


CONTROli.-D 
>-----..i 
Active 
Missions. 


File 


The lib:vary containing repo11t decollating m1ss1on· definitions is referenced by DD 
statement DAREPMIS .. This DD statement is no11mally included in the CONTROI:..-M User 
Daily job: However, if at youv site jobs ordered via the New Day procedure have 
decollating missions, DD statement DAREPMIS must also be included in CONTROL-M 


New Day procedure .. Add' DD statement DAREPMIS to procedures CONTDAY and/or 
CTMDAILY, the CL.IST CTMCJOBS, the Online monitor, etc; 


More than one partitioned dataset may be referenced by each DD statement DAREPMIS 


(in a job 1 011 CLIST). If a library is not referenced, an error message is produced and the 


CONTROL-M New Day procedure or the User Daily job skips to the next job; 


If you wish to use more than one library to store definitions 0:£ report decollating missions, 


mo11e than one CONTROL-M Daily may be used. This usually cor:responds with using move 


than one CONTROL-M scheduling librar:y (for security reasons). 
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Example (Relevant DD Statements Only): 


CONTROL-M User Daily Job 1 


llDACHK 
llDAJOB 
II 
II 


llDAREPMI:S 
llDAAMF 
II 


DD 


DD 


DD 


DD 


DD 


DD 


DI:SP=SHR1DSN=parm-library-1(date-CONTROL-record-1) 
DI:SP=SHR1DSN=scheduling-library-1(table-1) 
DI!SP=SHR1DSN=scheduling-library-1(table-2) 


DI:SP=SHR1DSN=sc:heduling-library-1(tab1e-3) 
DI:SP=SHR,DSN=report-definitions-library-1 


DI:SP=SHR1DSN=the-CONTROL-D-ac:tive-missions-file 


CONTROL-M User Daily Job 2 


llUSER02 
EXEC 
C'l'MDAI:LY 


llDACHK 
DD 
DI:SP=SHR,DSN=parm-library-2(date-CONTROL-rec:ord-2) 
llDAJOB 
DD 
DI:SP=SHR,DSN=scheduJ.ing-library-2(tabJ,;e-1) 
II 
DD 
DI:SP=SHR1DSN=sc:heduling-library-2(tab1e-2) 


llDAREPMI:S 
DD· 
DI!SP=SHR,DSN=report-definitions-library-2 
llDAAMF 
DD 
DI:SP=SHR,DSN=the-CONTROL-D-active-missions-file 


For a full description of the CONTROL-M New Day pvocessing, see the beginning of 
Section 3 •in this guide. 


Job-Report Dependency 


It is recommended to establish dependency between the successful· execution of the job 
under CONTROL-M and the pvocessing of the job~s reports by the CONTROL-D report 
decollating mission. The dependency can be established using a prerequisite condition. 


Pal'ameter OlJT of the job ovder undel' CONTROI:..-M should specify a prerequisite 
condition: to be referenced by parameter IN of the CONTROL-D repol't decollating mission. 


Prerequisite 
Condition 
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JQIB Order 


OUT 


- A - ENDED - OK 


IN 


CONTROL-D 
Decollating Mission 
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Using CONTROL-M Scheduling Data - Summary 


The advantage of invoking the CONTROL-D report decollating missions via CONTROL-M 


scheduling criteria is that the scheduling criteria only have to be defined once (under 


CONTROL-M). It is then1 unnecessariy to update the scheduling criteria of CONTROb-D 


each time the criteria arie updated in CONTROL..-M. In addition, ad hoc job oriders under 


CONTROL-M automatically place reporit decollating missions in1 the CONTROL-D Active 
Missions file. 


The job scheduling information is managed by one source of data and controh 


Scheduling via the CONTROL-M Production Control System 


When the CONTROL-M p1!oduction1 control: system is ini use, the integJCated' environment of 


CONTROL-D and CONTROL-M can produce optimum results. 


In such an environment, the recommended method of scheduling a non-generic report 
decollating mission is via CONTROL-M scheduling criteria~ 


The CONTROL-M Job Scheduling Definition screen contains a field (CATEGORY) to 
indicate that a CONTROL-D report decollating mission' should be scheduled' whenever the 
job is scheduled to run under CONTROb-M. 


In this field, the user specifies the CONTROb-D categoriy of the report decollating mission 
that should be selected from the CONTROL-D reporit decollating mission library. To select 


all categories of the job; an 
1 asterisk (*) should be specified: in the CATEGORY field. (If the 


CATEGORY field: is empty, a report decollating mission is not scheduled for the job;) 


Each report decollating mission can 1 be composed of a few categoriies. The category is 
usually used as a mechanism' to specify different report decollating (processing) 
parameters fori different execution days (e.g., a regular work day, end: of the month). 


Based on: different scheduling criteria under the CONTROL-M monitoJC, the same 


CONTROL-M job orideri can be used: to select different report decollating missions of 
different categories .. 
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Scheduling 


Library 


JOB-A 


Workday Calendar 


CD Category DAILY 


JOB-A 
Workday.Calendar 


CD Category NOTWORK 


JOB-B 


Workday Calendar 


CD Category • 


CONTROL·D 


Report Decollating 


Mission Library 


JOB-A 


Category DAILY 


JOB-A 


Category NOTWORK 


JOB-B 


Category ANYDAY 
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When CONTROL-M and CONTROL-D operate together in the same environment, the 
following situations may avise: 


• A job toibe run by CONTROL-M does not generate any reports. Therefore, there is no need 
to process the job by CONTROL-D. In this case, the category field in, the CONTROL-M Job 


Scheduling Definition, screen should remain blank. 


• A job to be run by CONTROL-M generates a report but does not (yet) have a report 
decollating mission defined for the job: (CONTROL-D can be implemented in phases) .. In 
this case, the category field· in the CONTROI!..-M Job Scheduling Definition screen should 
remain' blank. 


• A job generates a report which should be decollated by a CONTROL-D report decollating 
mission. In this case, the name of the CONTROI!..-D category of the report decolla.ting 
mission should be defined in the CATEGORY field. in the CONTROL-M job scheduling 
definition. An asterisk(*) may be used to select all categories of the job .. 


Scheduling via a Non-CONTROL-M Production Control System 


The following methods can be used to implement CONTROL-Din data centers which use a 


non-CONTROL-M p:voduction control system: 


• CONTROI:..-D scheduling is managed independently of the production control system, This 
method is the same as managing the scheduling without any production control system, 


• The scheduling of report decollating missions under CONTROI:..-D is controlled by the 
production control' system (described in the following paragraphs). 


Most production control systems include some means of passing control to· a user exit befo11e 


a job is submitted •. Some products have user exits in earlier stages (when the decision to 
schedule a job for a specific day is made). The basic idea is to invoke the CONTROL-D report 
decollating mission from the user exit of the production control system, 


When a production control' system and CONTROL-D operate together in the same 
environment,.the following situations may arise: 


• A job which is to be run by the production control system does not have any reports. It does 


not need to be processed: by CONTROL-D. 


• A job which is to be run by the production control system does not yet have a report 
decollating mission. defined. for the job: 


• Ajob.is to be run.by the production control system and decollated by CONTROL-D. 


To handle the situations mentioned above, the user should use some method of specifying 
to the production control system user exit whether or not a report decollating mission 
should be issued fo11 the job: The decision of how to mark a job is local for each installation 


and 
1 can: be performed using one of the following methods: 


• Specify some of the job scheduling pa11ameters (of the production control system) that are 
otherwise unused, or a11e used for other pU11poses (e.g~, the job description). 


• Use a list internal to the user exit. The list must be modified whenever a new report 
decollating mission is defined. 
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When, the pr:oduction control system user exit receives control1 and a decision is made to 
invoke a repor:t decollating mission) the user exit should activate pr:ogram CTDRRQ, This 
program performs a search for: the repor:t decollating missioni. For more infor:mation about 


pr:ogram CTDRRQ and its parameters, see "Programs Called, During New Day Processing" 


in' Section 4 of this guide. 


The search, is made for a member: name with the same name as the job name and for the 
specified category. The scheduling criteria of: the CONTROL-D repor:t decollating mission 


(if any) are ignored. The repor:t decollating mission' parameters are passed to CONTROL-D 


user exit CTDXOOl. This exit may alter the contents of the decollating par:ameters or: 


cancel the Decollating mission. If the repor:t decollating mission' is not canceled by the exit, 
it is placed in the CONTROL-D Active Missions file. 


Usage Notes 


When1 a report decollating mission is scheduled by invoking pr:ogram CTDRRQ from a 
production control system user exit, the following DD statements must be usedc 


STEPLIB 


DAAMF 


DAOl!JT 


DALOG 


DAGENUSR 


IOA LOAD libraey (if not included in, the MVS Linklist). 


CONTROL-D Active Missions file. 


Output print file .. 


IOA Log file. 


Generic user names libr:ary (if this option1is used by yoill1 site). 
If the pr:oduction1 control1 system does not have an1 appr:opr:iate exit or: you do 1 not want to 
use this method to schedule report decollating missions, there is an altevnative. Most 
production, control systems are capable ofi producing a night plan repor:t - a list of: jobs to be 
executed during the night. This list can1 be used as input to a pr:ogram that will schedule 


repor:t decollating missions by invoking program CTDRRQ, 


Examples of pr:oduction control system interfaces can, be found 1 in the IOA SAMPLE 
libr:ary. Member $$INTER in, the SAMPLE librar:y contains an index of: all infovmation 


related to each, pr:oduction control system which is currently available in 1 the SAMPLE 


library. A user-writteni interface to CA-7 (UCC7), which is not officially supported, is 
available. Detailed interfaces to other production' control1 systems, based on the methods 
described above, will be available in the futul'e. (For: mor:e infor:mation. on1 the CA-7 (UCC7) 
interface, call your IOA representative.) 


Job-Report Dependency 


It is recommended to establish 
1 dependency between' the successful execution of the job 
under the production: control1 system and the processing of: the job's repor:ts by the 


CONTROL-D repor:t decollating mission. This dependency can, be established using the 
prerequisite condition concept. 


A pr:erequisite condition, (e.g., REP-MOlAUPD-READY) should be specified in the IN 
parameter ofi the CONTROL-D repor:t decollating missiom This condition is added to the 


IOA Conditions/Resources file by the pr:oduction control system after the job finishes 
executing successfully. 


Use utility IOACND to add, a condition, Utility IOACND can be activated from a 
production control system use11 exit, from a specially defined successor: task of the job 
under the pl'oduction control, system, or: from ajob step• 
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It is not mandatory to, establish prerequisite conditions dependency between the 
production control1 system and CONTROL-D. If dependency is not established, 


CONTROL-D will process the reports when the job appears on the output queue. It is also 
possible to use manual prerequisite conditions for report processing when required'. 


Using a Non-CONTROL-M Production Control System - Summary 


The advantage of invoking the CONTROL-D report decollating mission from the user exit 


ofi the production control' system is that scheduling criteria only have to be defined once 
(under the production control system~ .. The user does not have to update scheduling 
criteria of report decollating missions each time they are updated in the production control 
system. 


Considerations for When CONTROL-Mand CONTROL-D Are Installed 


The following issues should be considered if both CONTROI.-M and CONTROL-D are 
being installed: 


• In: previous releases ofi CONTROL-Mand CONTROl!.-D, it was necessary to modify some 


CONTROL-D daily JCL p11ocedures and CLISTs . .In the current release, no modifications aJ.le 


required; the appropriate CONTROL-M/CONTROL-D files aJ.le dynamically allocated. DD 


statement DAALOCIN points to a member in a partitioned dataset which contains a list ofi 
files that will: be dynamically allocated. 


• Utility IOACLRES cleans the IOA Conditions/Resources file .. 


It is recommended that only utility IOACLRES be used to clean the IOA 


Conditions/Resoul'ces file, because the same file is used for both CONTROl.-M and 


CONTROl.-D. We also recommend that these utilities all be assigned the same parameter 
control member via DB statement DACRSIN. 


• CONTROL-M New Day procedure CONTDAY updates the IOA Conditions/Resources file. It 
should delete all· the conditions which were left from last yew (conditions can, be kept up to a 
year) .. The CONTROL-M New Day procedure can receive parameters which control the 
delete operation. via DB statement DAFRMIN. When both CONTROL-M and' CONTROL-D 
axe installed, IOA installation parameter CTM must be set to Y (otherwise, results may be 
unpredictable). When CTM=Y, the CONTROl'.r-D New Day Procedure does not handle the 
conditions in the Conditions/Resources file; maintenance of conditions is handled by the 


CONTROL-M New Day procedul'e. Therefore, it is recommended that the CONTROL-M 


New Day procedure always be run1 before the CONTROl.-D New Day procedure. 


It is recommended to clean the IOA Conditions/Resources file periodically using utility 


IOACLRES. 


• Utility IOALDNRS builds the Manual1 Conditions file from inforniation in the CONTROL-M 


Active Jobs file, the CONTROL-D Active Missions file, and the IOA Conditions/Resources 
file. However, "older" utilities CTMLDNRS and CTDLDNRS, which perform the same 


function~ axe also supplied fol' compatibility with previous releases of CONTROL-M and 


CONTROL-D. 


We strongly recommend that only utility IOALDNRS be used to build the Manual 


Conditions file because the same file is used for both CONTROL-Mand CONTROL-D. We 
also recommend that these utilities all be assigned the same parameter control: member via 
DD statement DALNRIN. 
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Printing Mission Management 


Various aspects 0£ managing printing missions are explained, under the following topics: 


• Printing Mission, Execution Wor:kflow 


- 
Printing Mission Definition, Screen: 


• Advanced Scheduling Issues: 


- 
Distribution Acco11ding to Scheduling Dates 


- 
Repollt Decollating and Printing Mission Dependency 


• Printer Control 


• Identifying Chunks on Spool: 


• Printing on: AFP (AP A) Printers 


• Printing Using XEROX DJDE Pwameters 


• Advanced ACIF Interface Facility 


• Using OBTPARM for Global Control:o£Printing Characteristics 


• Printing to a File 
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Printing Mission Execution Workflow 


The Printing Mission workflow of CONTROL-D is shown. It illustrates the stages involved 


from initially scheduling the pdnting mission through printing repoxts. 


CREATE 


PRINT PLAN 


NO 


CREATE 


PRINT 
MISSION 
LIBRARY 


PASS 


SCHEDULE 


EXECUTE 


The execution, wovkflow of a printing mission is performed as follows: 


The Active User file is scanned by the CONTROL-D monitov for all repo:vts requiring 
p:vinting by the specified printing mission. (This is a fast scan, not a scan of the entire file.) 
The result of this pvocess is a Print Plan file which includes entries for repo:vts to be 
printed. In addition, the CONTROL-D monitor selects an available logical printer fo:v this 


p:vinting mission. 
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When' the printer is selected, the control is passed either: 


• To the Printers Control monitor (CTDPRINT), ifthe BATCH parameter was set to N, 


or 


• To a batch job if the BATCH parameter was set to Y. 


The p11int process continues either by the Printers Control1 monito11 or by the batch job. 


Chunks are sent to the spool depending on specific parameters such as CHUNKSIZE and 


OVERRIDE .. See "Printer Controll' later in this section' fo11 further details. 


After p11inting is completed, the status of each report entry from the Print Plan file is 
updated' in1 the Active User Report List file acco11ding to· the printing completion status 


(e.g·.,.Printed/Not p11inted~. 


Processing of Batch Printing Mission 


When the report is printed by a batchjob; the following p11ocess is performed: 


The CONTROl!r-D monitor reads a skeleton job fromi the lib11a.cy referenced by DB statement 


DADSKL o:f the CONTROL-D monito11. The member name is defined in the printing mission 
(e.g., PRTSKL). 


Printing Mission Definition Screen 


BATCH 


SKELETON 


FREE 


TIMEOUJT 


Specifies whether a printing mission is submitted as a subtask of a 
Printers Control monitor, or as a batchjob: 


Y (Yes) CUMent printing mission is submitted as a batch job instead 
1 ofi 
executing it as a subtask of the Printers Control monitor. 


N (No} 
Printing mission is executed as a subtask ofi the Printers Control1 


monitor. Default. 


Name of an existing member in the CONTROL-D SKL library. Mandatoey 
i:fBATCH is settoY. 


Sysout allbcation' mode. Determines whether 011 not chunking is 
implemented and when sysout files will be freed~ Optional. Valid values 


we: 


CLOSE Regular chunking mechanism is used. Default. 


END 
Sysout files a11e allocated as usual but are not freed until the end 


of the batch job. This value is available only if BATCH= Y is 
specified. 


Numbe11 of minutes within' which the mission should start. If the 
mission does not start during the specified time interval, it 
terminates NOTOK. Default: 5 minutes. 


See Section 4 of the CONTROL-D User Manual for more info11mation about the BATCH 


parameter. 
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To use a printing mission in, batch mode, a skeleton member must be prepared in, the 


CONTROL-D SKL library. The skeleton member can be either a job skeletoni.or a started task 


skeleton, See sample member PRTSKL in, the CONTROL-D SKL library. 


• The skeleton, member can contain 
1 certain parameters which are interpreted by the 


CONTROL.-D monitor. The parameters are: 


%COM#% 


%MISSION% 


Number of the COM file record assignedto this mission. 


Mission: name. 


%CATEGORY% Mission category. 


%GROUP% 


%OWNER% 


%PRTY% 


%DEST% 


Mission group. 


Mission owner ID. 


Mission priority. 


Mission destination~ 


• Wb.en1 CONTROL-D finishes preparing the member for submission~ control1 is passed to 


CONTRC>L-D user exit CTDX009. This exit can modify the contents of the submittedjob (by 
adding, deleting or modifying the JCL). The exit can return the following return codes: 


0 Submit the job: 


4 Do not submit the job: User exit CTDX009 can, request CONTROL-M to submit the job: 


Job. submission, can: be done via CTMAJ© routines to, ensul'ie correct handling of the print 


job under CONTROL.-M, 


8 Do :not submit the job. Terminate the mission' with NOTOK status. 


Synchronization between the running job and the CONTROL-D monitor is achieved in the 
same manner as synchronization' between' CONTROL-D and the Printers Control monito11, 


i.e., a special control subtask exists fol' each, printing mission in the CONTROL-D address 
space. This subtask is synchronized, with the conesponding print task via the ENQ 
mechanism. The QNAME for this ENQ is takeni from the CONTROL-D installation 
parameter PRTSTC (in: member CTDPARM in the IOA INSTCTD library). To run: a batch 
printing mission on: a CPU which is different from the CPU in which the CONTROL-D 


monitor runs, this QNAME should be shared through GRS, MIM1 or other enqueue 
manager products. 


If parameter PRTMON# is set to 0 in member CTDPARM, no Printers Control, monitors 
are started .. In this case, parameter BATCH in the printing mission must be set to Y. 


See "One-Outgroup Method" under "Printer ControU' later in this section, for additional 
considerations on running pl'inting missions in batch mode. 


Note 
Printing mission abend or timeout does not cause termination of CONTROL-D 


monitors. In such cases, the printing mission terminates with a status of NOTOK. 
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Advanced Scheduling Issues 


Distribution According to Scheduling Dates 


It is possible to organize printing missions so 1 that each' day's printing management (i.e., 
the printing workflow) is the same. The simplest solution is to specify DAYS=ALL in the 
Basic Scheduling parameters of all printing missions. Once a day, when the printing 
missions New Day p11ocedure is in¥okedi all printing missions scheduled for the next 24 
hours are placed in the Active Missions file. 


This printing organization: does not maximiize the capabilities of CONTROL-D. You can 
organize the p11inting orde11 in different ways for different days (e.g., a weekday, the end of 
the week, the end of the month, holidays). Using CONTROL-D it is possible to define 
several copies of the same printing mission. Each copy is an, independent definition of the 


p11inting mission and should have different scheduling criteria, different runtime criteria, 
different bundling instructions, different printing configurations, etc: 


Example 


The (form~ STD printing mission wiU start not later than 1 05:00 on every workday, will 


sta11t not later than 04:00 at the end of the month, and will not be scheduled fo11 holidays. 


Since there is no limit to the number of p11inting missions which can' be defined, the use11 


can, organize the printing process to optimally suit every p11oduction day of the year. 


Report Decollating and Printing Mission Dependency 


It is recommended to establish, dependency between the successful decollation of reports 
and the p11inting of bundles by CONTROL-D printing missions. Dependency can be 
established using the p11erequisite condition, concept .. Parameter OUT of the report 
decollating mission' should specify a prerequisite condition, that is referenced by paramete11 


IN of: the printing mission .. Using this method, bundles start printing only when all the 
reports which must be included in them have been decollated. 


It is possible to define different report-p11inting dependencies foll different scheduling dates 
(e.g., regular dates vs. end of the month). This can be done, as described, above, by using 
multiple copies of the same printing mission> each1 one distinguished by different basic 
scheduling criteria and different runtime scheduling criteria (prerequisite conditions, 
time, prio11ity, etc). 


Printer Control 


CONTROL-D provides the following methods fo11 p11inting bundles: 


One-Chunk Method 


Multi-Chunk Method 


One-Outgroup Method 
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Send entire bundle to, spool for printing. 


Send a specified number of: lines at time to the spooHor printing. 


Send one outgroup at the end of a printing mission that contains 
many sysout files. 
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One-Chunk Method 


The entire bundle is sent to the spool1 for piiinting at one time. This method is activated by 
specifying CHUNKSIZE=O in1 the printing mission' definition. If not specified in the 
p11inting mission definition1 CHUNKSIZE defaults to the value defined in paramete11 
PRINTER during the installation process. Specifying CHUNKSIZE=O suppresses 


installation' parameter Ot:JTGRP. 


This method can1 be used fo:r p11inting reports that contain identical printing 


cha11acteristics .. If reports containing different printing characteristics are processed in this 
manner, the cha11acteristics of the first report are used for aUthe reports in the bundle. 


Note 
If the bundle contains reports for different printing destinations,. a separate chunk is 
created for each destination but CONTROL-D does not monitor the printing of the 
chunk. CONTROL-D continues to send additional chunks of the bundle to the spool. 


Multi-Chunk Method 


CONTROL-D creates a new chunk each time the number of lines specified in the 


CHUNKSIZE parameter is exceeded, or when printing characteristics of the reports change, 
whichever comes fi11st (unless CHUNKSIZE is specified, as "O" as described in the One-Chunk 


method above). CHUNKSIZE can be specified in, the printing mission definition• If it is not 
specified in the printing mission definition, CHUNKSIZE defaults to the value defined 
during the installation p11ocess .. Fo11 the Multi-Chunk method, the value for the CHUNKSIZE 
parameter must be greater than 1; the recommended value is 10000. 


Multi-Chunk p11ocessing provides the following major advantages: 


• The ability to print reports with different printing characteristics in the same bundle. 


• The ability to control: the size ofithe chunkso.the·spool does not become overloaded. 


Under the Multi-Chunk method, the printer must be set to CONTROL-D using the 
following JES commands. 


UnderJES2 


A printer is normally defined to JES as DEST=LOCAL with one or more printing classes. 
To "assign~ the printer to CONTROL-D, use a JES operator command to initialize the 
p11inter with the following parameters: 


NOSEP 


DEST 


SEPDS 


CLASS 


No separator; CONTROL-D creates its own banner pages. 


A value set during CONTROL-D installation for each printer. 


No dataset separator. 


All output classes on which CONTROL-D can print. 


Sample JES2 operator command: 


$TPRT1,S=N,R=U1001,SEPilS=N,WS=(-W,-Q,-PRM,-LIM/R,-F,-UCS,-FCB) 
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Under JESS 


Change the printer options using an operator command. Initialize the printer with the 
following parameters: 


NOSEP 


CLASS 


No separator; CONTROL-D creates its own, banner pages. 


The class defi.nedinCONTROL-D installation,parameter PRINTCL. 


Sample JES3 operator commands: (PRINTCL=Q) 


*WTR OUT=04E,H=N,B=N,WC=Q,WS=CL 


*S 04E 


where * is the JES3 command prefix. 


Verify that the p11inter has been modified success£ully with all the above attributes. 


One-Outgroup Method (JES2 Only) 


It is possible to combine all: the output files produced by a printing mission' in one output 
group. Such a method is useful to ensure that all files will be printed together even, if the 


JES p11inter is not dedicated to CONTROL-D and is used for other jobs as well as for 


CONTROl.-D reports .. It is also, useful, for output files that are sent th11ough NJE to a 
remote computer. 


To combine the output files, perform the follbwing steps: 


1. Run the printing mission' as a batchjob; (Set parameter BATCH to Yin the Printing Mission' 
Definition screen,) 


2. Free alli sysout files at the end o~ the job (Set parameter FREE to END in, the Printing 


Mission Definition screen,) 


3:. Note the following: 


• Parameters CLASS, DEST, WTRNAME, PRMODE and, OBTGROUP should' be the same 
for all! reports included, in the printing mission~ 


• Parameter OVERRIDE in1 the Printing Mission Definition screen' can be used to fo11ce 


parameters CLASS, DEST and WTRNAME. 


• Parameters PRMODE=PAGE and GROUPID=CONTROLD should, be defined in all 


OUTPUT statements in the Printers Control monitor JCL procedUlle (CTDPRINT). 


4. Set parameter USERSET to, YES in the OUTDEF statement in member JES2P ARM in, the 


SYSl.PARMLIB library. 


5. Verify that the output class is anon-held class. 


Opening/Closing Printers 


During installation, a value of OPEN or CLOSE was assigned to parameter PRINTER for 


each printer. If the printer was defined as OPEN, skip to "Printing Process''. If the printer 
was defined as CLOSE, use the follbwing command to "open" a CONTROL-D printer: 


F CONTROLD1 STARTPRT,printername 
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Where printername is the name assigned during CONTROL-D installation. The following 
message is issued to the operator console from which the modify command was issued: 


CTD130~ COMMAND "STARTPRT" ACCEPTED FOR PRXN'l'ER printername 


To "close" a CONTROL-D printer, enter the following operator command: 


F CON'l'ROLD,S'rOPPRT,printername 


When there are no CONTROL-D bundles to print, you can reset the printer's original 
parameters with a JES command. 


Note 
It is not necessary to "close" CONTROL-D printers. A printer remains "open" but 
nothing is printed if the JES2~DEST or JES3~CLASS setting of the printer is not 
assigned to CONTROL-D. 


Printing Process 


When a printing mission is activated (either manually or automatically), the printing 
mission creates an 1 index of all reports which are ready to print and which we11e specified 
to be printed 
1 by this particular p11inting mission. This index can be viewed and controlled 
online using the Print Control option (P) in the Active Missions screen. The bundle is then, 
prepared for p:riinting. 


CONTROL-D searches for an available printer that was defined 
1 in parameter PRINTER of 
the p11inting mission definition,. If parameter PRINTER has not been specified, 


CONTROl.-D searches for any available printer that was defined in installation parameter 
PRINTER. 


If a pvinter was defined as CLOSE, an operator command is required to OPEN the printer 
to CONTROL-D (as described earlier in this section~. If a printer was defined as OPEN or 
if the operator command' was issued, CONTR01'-D sends the bundle to the spool 
1 for 
printing. 


When using the One-Chunk method) the full bundle is created on, the spool' and waits in 
queue to, print (along with any other output that may be on the spool - i.e., non~ 
CONTROL-D output). 


When' using the Multi-Chunk method, it is recommended to send only CONTROL-D 


bundles to the pl1inter at a specified time. If the printer is not assigned exclusively to 


CONTROL-D when, using the Multi-Chunk method, non-CONTROL-D output may be 
printed in a CONTROL-D bundle .. (Assigning a printer to CONTROL-D is described earlier 
in, this section,) After the bundles finish printing, the pvinter can be assigned to print 


non~CONTROL-D output. 


Bundle printing can be interrupted using the Print Control optfon, in the Active Missions 


Status screen, This may be required. to immediately print an important non-CONTROL-D 


output, to change priority of a report printed by CONTROL-D, or to perform any other 
desired action during the printing process. Refer to Section 2 of the CONTROL-D User 
Manual for a detailed description of this option. 
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Identifying CONTROL-D Chunks on Spool (JES2 Only) 


CONTROL-D provides the ability to identify each chunk that is sent to the JES output 
queue in a unique way. This is done by setting the OUTGROUP field (GROUPID in JCL, 
0-GRP-N in 
1 SDSF) on the chunks that CONTROL-D sends to the spooh 


The following a11e types of identifications which CONTROL-D can' put into the 


OUTGROUP field: 


1. The o:ciginal1job name of the repollt. 


2: The user name oHhe user (e.g~, recipient) who is to 
1receive the report. 


3. The pl1inting mission 1name. 


4. A unique time stamp. 


5, Specific string specified in, the pl1inti.ngmission. 


To activate this feature, do the following: 


l. Add a special Ol!JTPUT statement to the CONTROii,-D Printers Control, monito11 procedure 
(CTDPRINT). It must be coded as follows: 


//OUTGROUP·OtJU'PUT GROUP:CD=CON'l'ROLD· 


If the site runs mo11e than one Printers Control monito11 (CTDPRIN2, etc;), add this DD 
statement to aUthe Printers Control monitor procedures. 


2. Add operand GROl!JPID=CONTROLD to alli OUTPUT statements in the Printers Control 


monito11 procedure(s). This operand must be coded: in the first operand in the OUTPUT 


statements. 


3. Set the OUTGRP CONTROL-D installation pwameter in1 member CTDPARM in the IOA 
INSTCTD lib11a11y as detailed in the IOA Installatiom Guide. 


We recommend specifying OUTGRP=Y, and using the GROl!JP field in the printing mission 
definition to define OUTGROUP p11ocessing. Refer to the CONTROL-D User Manual fo11 


details on using the GROUP field. 


Printing on AFP (APA) Printers 


AFP (Advanced, Function Printing p11esentation~ is the standa11d IBM laser p11inting 
technology which suppo11ts printers such as the 39xx family of printers and the 38xx family 
of printers, and uses APA (All Points Addressable) technology. Throughout this guide and 
in the CONTROL-D User Manual1 these printers a11e referred to as AFP printers. The way 
in which CONTROL-D supports AFP p11inters is described. Additional information 
including instructions fo11 local adaptations can be found, in the step that implements AFP 
Suppo11t in: the IOA Installation Guide, and in the publication, "Implementing AFP in the 


CONTROL-D Environment." 


When a sysout is p11inted on AFP printers, two additional printing control parameters are 
added:. FORMDEF and PAGEDEF. These parameters cannot be defined in a standard DD 
statement. Instead, they are specified in an OtJTPUT statement .. This output statement is 
referenced by a DD statement. 
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Support for PAGEDEF and FORMDEF in CONTROL-D is implemented in two ways - one 
is parallel to the JCL app:voach (using a specified OUTPUT statement) and one is more 
flexible and easier to use (using the CDAM PAGEDEF/FORMDEF parameters). 


Using the CDAM PAGEDEF/FORMDEF Parameters 


Under CONTROL-D you can1 specify parameters FORMDEF and, PAGEDEF without 
actually using an OUTPUT statement. When writing directly to a CDAM file, use the 


CDAM parameters PAGEDEF and FORMDEF. When you decollate a report from spool1 


you must specify the requested PAGEDEF/FORMDEF in the decollation mission definition 


PRINT/CDAM, PARMS field. 


Note 
This option is not supported when using the One-Chunk method~ See "Printer Control" 


earlier in this section. 


When using this option, during the pl'linting process CONTROL-D looks foll an OUTPUT 


statement named, CONTROLD or CONTROLF and automatically inserts inline FORMDEF 


and PAGEDEF. This option, utilizes the AFP Inline Resource Option, 


A CONTROLD and CONTROLF OUTPUT statement must exist under all p:vinting 


environments (the Printers Control monitor, the IOA Online monitol'I, the TSO user, etc.). 
See "AFP Suppollt" in' the IOA Installation Guide fo:v site adaptations required for AFP 
suppol'lt. 


Using a Specified OUTPUT Statement 


The name of an OUTPUT statement containing the FORMDEF/PAGEDEF combination 
can, be specified~ When: writing directly to· a CDAM file, use CDAM parameter OUTPUT. 
When decollating a report from spool; specify the requested OUTPUT statement in the 
decollating mission definition PRINT/CDAM PARMS field. Any OBTPUT specified in the 


PRINT/CDAM PARMS field overrides any such parameter specified in the DD statement 
during CDAM file creation. 


Note 
The name of the OUTPUT statement used is the name under the Printers Control 
monitor and not the name of the OUTPUT statement in the job that created the sysout. 


When using this option, CONTROL-D searches for the specified OUTPUT statement and 
uses it to p:vint the repoI1t. 


With this method, an OUTPTIT statement must exist under all printing environments (the 
Printers Control monitor, the IOA Online monitol'I, the TSO user, ete;) for every 
combination of FORMDEF/PAGEDEF which is in use. See "AFP Support" in the IOA 


Installation Guide for site adaptations required for AFP support. 


AFP Page Mode Output 


Any AFP report (including Page Mode reports) can be decollated by CONTROL-D. 


DecoUating includes identifying each and every page ofi a report with identifying strings 
and assigning the pages of the report to recipients accordingly. CONTROL-D recognizes 
page breaks in AFP Page Mode output (CATEGORY 5). 
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Searching fo11 a string in Page Mode output can be pe11formed on the entire line of data, as 
supported by AFP (from column 1 to 1 column' 32767). 


Page Mode output is usually produced by DCF (IBM's mainframe word pnocessor) when 
making Composed AFP documents, by GDDM and other software tools (such as SLR) that 
use GDDM for producing graphic reports and PostScript output (translated to AFP 


Structured Fields), and by application programs. 


Page Markers Under AFP 


Page Markers for differentiating between' user bundles (p11int perforation markers on page) 
can be initiated using standard methods with most printers. (See the "I:mplementing AFP 


in, a CONTROL-D Environment" guide for details.) The exception,is the 3800~3 p:l'inter. For 
special 3800-3 printer Page Markers, refer to member D©CDPAGM ini the IOA 
SECtJDATA library. 


In-Stream AFP Control Statements 


A major feature 0£ CONTROL-D is the automatic insertion 0£ AFP control parameters 
in-stream1 in reports.· This feature is especially useful, fo11 the following situations: 


• Implementation of advanced AFP options: 


When, using this featul'e, application programs do, not need modification, to· enable insertion 


ofAFP control1par:ameters (structured fields) within, reports. 


• When1 AFP control1 pwameters we contained in1 the sysout itself, at the beginning, and the 
sysout is decollated into different users' bundles: 


In such a situation~ the AFP control parameters would' no11mally be missing from all but the 
first user bundle .. This featuve can verify that the AFP control: par:ameters ar:e automatically 
inserted in each user's bundle. 


This feature operates as follows: 


A special libnary is used to define the AFP control' parameters of each repo11t. This library 
is referenced by DD statement DAAP A of the Printers Control1 monitor. The olliginal name 
supplied is OLPREFD.APAPARM. 


The lib11ary can be defined as RECFMo:::V 011 RECFM=F. By default, it is defined as 


RECFM=V. RECFMo:::V is highly recommended, because if you are using an APAPARM 
library with RECFM=F, you should add foul' bytes of length (RDW) before every AFP 


control' par:ameter and befo11e command IMMIIDM. 


The APAPARM lib11ary contains one member fo11 each job which p11oduces output to be 
printed on AFP p11inters. The member name must be identical to the job name. Each 


member contains AFP control' pa11ameters for all reponts p11oduced by the job. 


Note 
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• In each member, there must be one line in' the following format for each AFP report 
produced by this job: 


+++repname 
( +++ starts in column 1) 


Where: 


+++ 
Identifies the line as a report name line. 


repname 
Name (or mask) of the report (maximum of20 characters). repname must 
be the same as the name of the report specified in Repom Decollating 
parameter DO NAME. 


Note 
Any number of +++repname lines can be present in one member 
(i.e., a few reports can be produced by the same job). 


• Following the +++repname·line, one or more AFP control parameters records may follow. 


Any AFP command can, be· specified in its original A:FP hexadecimal format. The following 
special: commands can also appear as AFP control: parameter records: 


IMM=copy-group ... name 
(a maximum of eight characters) 


IDM=page-format-name 
(a maximum of eight characters) 


These commands are then1 translated to the appropriate hexadecimal AFP structured fields 
IMMandIDM. 


Note 
If you are using AP AP ARM libnaries with RECFM=F, you should add four bytes· of 
length (RDW) before every AFP control parameter and before command IMM/ IDM. 


Example 


Consider the following report decollating mission parameters: 


JOBNAME=AR:I:NS1 


DO NAME=AR-REPORT-1 


DO NAME=AR-REPORT-2 


Membe11 ARINSl in the CONTROL-D AP ARARM library can contain the following: 


+++AR-REPORT-1 


IMM=GROUP1 


IDM=PAGFM1 


+++AR-REPORT-2 


IMM=GROUP2 


When CONTROL-D prunts the reporit named ar-report-1, the two lines following the +++ 
line are written at the beginning of the report. 


When CONTROL-D prints the report named ar-report-2, the last line in the member is 
written to· the reporit. 


Sample member APARARMS is located in, the CONTROL-D APARARM libriary. 


Not every job has special AFP control parameters. The library should only contain 
members fori jobs with in-streamAFP control parameters and not fori other jobs .. 
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When' the Printers Control monitor 011 a batch pvinting mission is about to. pvint a repo11t 


for a user on an AFP printer, it searches for a membev name with the same name as the 
job which produced the repo11t. It looks for the repo11t name in the member, translates any- 


IMM/IDM commands to· hexadecimal, and writes all the report's AFP control' pavameters to 
the printer (via the spoon. AFP printers must be defined as APA in· member CTDPARM. 
(See "Performing Post-Installation Tasks" in the IOA Installation• Guide for mo11e 
info11mation,) 


Printing Using XEROX LCDS (DJDE) Parameters 


For many XEROX printer models (9700, 8700, etc:), it may be necessa11y to.specify different 


p11inting options using special control records which are inserted in the sysout directed· to 
the p11inte11. These paramete11s ave usually referred to as DJDE parametevs. The way in• 
which CONTROL-D supports DJDE pa11ameters is described below. Additional info11mation· 


including instructions fo11 local adaptations can1 be found in the IOA Installation Guide. 


A special library is used to define the DJDE parameters of each report. This library is 
referenced' by DD statement DADJDE of the Printers Control monito11. The original name 
supplied is OLPREFD.DJDEPARM. 


The CONTROL-D DJDEPARM lib11a11y contains one member for each job which pl'oduces 
output to be printed on· XEROX p11inters .. The member name must be identical to the job 
name. Each member contains DJDE paramete11s for alli repo11ts produced by the job. 


Note 
If yow use the DJDEP ARM option {on online printing, be sure your online environment 
(e.g., IOA Online monitor, TSO Logon pnocedure) is referenced by DD statement 
DADJDE. 


fo, each· member, there must be one line in the following fol'mat for each repo11t p11oduced· 


by this job:. 


+++repname 


+++ 


repname 


( +++ starts in: column• 1) 


Identifies the line as a repoJ:lt name line 


This is the name or mask of the report (maximum 20 ch0.11acters). 


repname must be the same as the name of the report specified in report 


decollating pa11ameter DO NAME. 


One 011 more DJDE control1 parameters reco11ds may follow the +++repname line. 


Note 
Any number of +++repname lines can be pnesent in one member (i.e.,. a few reports can 
be produced by the same job). 


Example 


Consider the following report decollating mission parameters: 


JOBNAME=AR:CNS1 


DO NAME=AR•REPORT-1 


DO NAME=AR•REPORT-2 
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Member ARINSl in the CONTROL-D DJDEPARM lib:riary can' contain the following: 


+++AR•REPORT-1 


D.JDE 
C MULTI RECORD·D.JDE EXAMPLE 


DJDE 
FORMS=(XEROX1,1,3),FGRMAT=XPDE12,FGN'l'INDEX=1,NUMBER=(3,15,55),; 


DJDE 
COLLATE=YES,ASSIGN=(l,S),ASSIGN=(S,32),; 


D.JDE 
FGN'l'S=((P0612A),(P0812A)),; 


DJDE 
ASSIGN=(12,63),TOF=S,BOF=66,END; 


+++AR•REPORT-2 · 


D.JDE 
JDE=JDEAR3,JDL=JDLAR3,END; 


When CONTROL-D p11ints the report named ar-repovt-1 (pl'oduced by the job ARINSl), the 
multi-record DJDE example lines are written: to the report. 


When CONTROL-D pvints the report named ar-report-2; the DJDE line (JDE=JDEAR3) is 
written to the repovt. 


A sample member JDEFARMS can: be found in, the CONTROL-D DJDEPARM libvary. 


Note 
Not every job has special DJDE parameters. Many jobs are printed using the default 
DJDE parameters. The library should contain only DJDE parameters (i.e., members) 
for jobs with special DJDE parameters and not for other jobs. 


When the Printers Control monitor is about to· print a repol't fov a user on a XEROX 
p11inter, it searches for a member name with the same name as the job which produced the 
report. It looks for the repol't name in the member, and writes all the report's DJDE 
parameters to·the pvinter (via the spool~. The DJDE pvefix and offset should be specified in 
macro CTDUDJP. The pvinter must be defined as XER in member CTDPARM. (See 
"Perfovming Post-Installation Tasks" in the IOA Installation Guide for mo:rie information.) 


Advanced ACIF Interface Facility 


The CONTROL-D Advanced ACIF Interface facility automatically converts selected 
reports destined fo11 PC file transfer to, AFP Category 5 data stream (AFPDS) format, 
making them available for display with the CONTROL-D/PC fo11 Windows AFP Viewing 


component. 


What is AFPDS? 


AFPDS (Advanced Function Presentation Data Stream., - also known as an 1 AFP Category 5 
data stream~ is a data stream format that allows for graphical WYSIWYG viewing, and 


pl1inting of reports on AFP supported devices and platforms. 


AFPDS can contain graphics, text, image and bar code objects .. AFPDS also supports print 
resources such as fonts, overlays, page segments, fovm definitions and page definitions. 


What is ACIF? 


AClF (AFP Conversion and Indexing facility) is a utility that is supplied as a standard 
component o:tPSF/MVS (Print Services facility) Version 2.1.l and above. 
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Make ACIF Accessible to CONTROL-D 


It is recommended that ACIF p11ogram module APKACIF be located' in, the LPA 011 in an 


MVS LINKLIST lib11ary. Otherwise, all CONTROL-D Printers Control monito11 JCL 
procedures must be manually edited to concatenate the ACIF distribution' LOAD lib11ary to 
the STEPLIB DD statement. 


The default name of the ACIF distribution1 LOAD library (as documented in the IBM 
installation' instructions fo11 PSF) is PSF .ACIF .AAPKMOB 1. 


See the CONTROL-D installation: p11ocedure for MVS and PSF release p11erequisites. 


The majo11 benefits of the ACIF utility are: 


• Converting Line Mode Output to Page Mode Output 


ACIF can convert line mode output to full AFP Categocy 5. data stream: (AFPDS) page mode 
output. AFPDS output can be displayed under CONTROL-D/PC for Windows with the AFP 


Viewing component (technology fromithe IBM Printing Systems Company) .. 


• Indexing Reports 


ACIF can: optionally index repo:rts according to character strings at specified lines and 
positions within a report. For example, ACIF can produce an1 index according to· account 
number and client name data contained in a customer statement. The index enables direct 
access to specific repo:rt pages when' displayed with CONTROL-D/PC for Windows. 


• Saving/Archiving External Resources 


ACIF can create encapsulated AFPDS files that contain all the resoUJ.lces requi11ed for AFP 


printing and presentation, These resources include FORMDEFs, electronic overlays, page 
segments and fonts. The resoUJ.lces can: be combined with the repollt and index data and 
saved' as a standard sequential, file. This file can: be printed or viewed at a later date in 
1 its 
original: fol.1ffiat, without regard to. resoUJ.lce availability or subsequent changes to the 
resource definitions. The file can also· be transfeNed to· other sites or platf o11ms fo11 viewing 


and 
1 printing~ If transferred to the PC environment, the output can' be viewed online using 


CONTROL-D/PC for Windows. 


For mo11e detailed' information1 on• ACIF, refer to· the ACIF Application Programming Guide 
(IBM publication number G544-3824) or subsequent documentation, 


Activating the Advanced ACIF Interface 


By specifying CDAM parameter ACIF=YES in, a report's decollating mission definition~ 
CONTROb-D automatically calls ACIF during p11inting mission p11ocessing if the report is 
destined for PC file transfer. ACIF converts the repo11t to· AFPDS fol'mat. The report can 
then be transferred. to CONTROL-D/PC for Windows fo11 display. 


ACIF Execution Parameters 


ACIF requires pa11ameters at execution' time to control1 the p11ocessing of resources and 
conversion of repo11t data to· AFPE>S fo:r~mat. 


Many parameters specified, to ACIF a11e the same as p11inting parameters specified in: JCL 


statements when' p11inting a job .. Some pa11ameters are used to specify the names of 


datasets where resource definition1 members cani be found. Other parameters are available 
to define the report index that ACIF can optionally compile .. 
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These parameters must be read by AClF from a sequential' file or a library member. While 
some reports can share common parameter settings, most repo:rits require settings that are 
in some way different from those specified for other repo:rits. Without the CONTROL-D 
ACIF Interface facility, tracking hundreds or thousands of ACIF parameter files or 
members becomes an impossible task. 


The ACIFP ARM Library 


For the CONTROb-D ACIF Interface facility, ACIF execution parameters are placed in the 


CONTROL-D AClFPARMlibrary. 


Unlike standa11d executions of ACIF, the CONTROL-D ACIF Interface facility allows the 
specification of different parameters for different repo11ts associated with the same job 
name, the same printing mission name, and/or the same recipient (user ID) name, to be 
kept in, a single member of the CONTROL-D ACIFP ARM library. 


By default, ACIFPARM member names must be identical to a report's original job name. 
However, as an optional enhancement, the ACIF Interface facility can be modified to 
associate member names with a repont's printing mission name or recipient name. 


In each member, one on more sets of ACIF execution parameters may exist for different 
reports .. Each such group must be p11eceded by a report name (repname) control1 statement 
in the following format: 
----+----1----+----2----+----3----+----4----+----s----+----6----+- 
+++repname 


+++ 


repname 


unitname 


uuuuuuuu xpxp xsxs rprp rsrs dpdp dsds c 


Indication that this is a report name (repname) statement. 


Name of the report (a maximum of 20 characters can be specified). The 
name must be the same as the name of the report specified in parameter 


DO NAME of the decollation1 mission· that created the report. 


The report name can' be specified explicitly, or may contain the following 
mask characters: 


* 


? 


Examples 


ABC* 


ABC*D 


* 


A?Bl 


Any character, group of characters, or no cha:riacter. 


Any single chanacter. 


The report name must begin with ABC (Le., prefix). 


The reporl name must endwithD (i.e., suffix). 


The report name must begin' with the prefix ABC and end 
with the suffix D. Any 011 no chanacter(s) may be present 
between the prefix and the suffix. 


All report names are selected~ 


The repo:rit name must begin with' a prefix 0£ A and end 
with a suffix ofi Bl. One character of any value must be 
present between the prefix and the suffix. 


Work unit name to be used by the CONTROL-D ACIF Interface facility to 
allocate temporary ACIF index, resource and report data files .. 
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p~ind 


s-ind 


s-res 


p-rep 


s-rep 


c 


Primary space allocation, in tracks, for the temporary ACIF index file. 


Secondary space allbcation, in tracks, fov the temporary ACIF index file. 


Primary space allocation, in tracks, for the temporary ACIF resouvce file. 


Secondary space alfocationi in tracks, for the tempovary ACI'F resource 


file. 


Primary space allocation1 in tracks, for the tempovary ACIF repo:rt data 
file. 


Secondary space allocation, in tracks, for the temporary ACIF report data 
file. 


JES output class to which ACIF prints its informational' or error message 
report. If left blank ov specified as an asterisk(*), the default MSGCLASS 


of the Printers Control monitor is assigned. 


ACIF execution parameters must immediately follow the repname statement. 


For detailed information. on available ACIF execution1 parameters, refer to the ACIF 


Application Programming Guide (IBM publication, number G544-3824) or subsequent 
documentation. 


Any number of repname and ACIF execution parameter groups can' be present in an 


ACIP ARM library member. 


Example 


Consider the following decollation mission parameters for two reports: 


JOBNAME=XXXXXXXX 


PRXNT/CDAM PARMS=ACXF=YES 


DO NAME=REPORT-NAME1 


DO NAME=REPORT-NAME2 


Member XXXXXXXX in the ACIFPARM library can contain the following: 


+++REPORT-NAME1 •••••••••••••••• 
ACXF EXECUTXON PARAMETER STATEMENTS 


+++REPORT-NAME2 


ACXF EXECUTXON PARAMETER STATEMENTS 


Default member $$$$DFLT inthe CONTROL-D ACIFPARM library contains default ACIF 


execution parameters. These parameters control how reports with no specifically 
associated member in the ACIFPARM library are pvocessed by the ACIF Interface facility. 


4-46 
IOA Rel. 5.0.0 Administrator Guide 


u 


u 


u 


Section 4: Customizing and Administering CONTROL-D and CONTROL-V 


Using OUTPARM for Global Control of Printing 
Characteristics 


The CONTROL-D Global Control of the Printing Characteristics option provides the ability 
to override the default printing characteristics (specified at decollation time) for all (ol' some) 
of the reports and banners to be printed by CONTROL-D. This option is for deferred pl'inting 
as well as for immediate printing. The following printing characteristics can1 be controlled: 


OBTPl:JT 


FCB 


FORMS 


CLASS 


DEST 


MODIFY 


FLASH 


PAGEDEF 


FORMDEF 


CHARS 


CHARl 


CHAR2 


CHAR3 


CHAR4 


OPTCD 


TRC 
ucs 


FLASHC 


BURST 


CHARI, CHAR2; CHAR3, and CHAR4, define specific character sets. CHARS defines the 
character set referenced by CHARl and nullifies CHAR2; CHAR3, and 'CHAR4. 


Setting parameter TRC (Table Reference Character) to YES p11oduces the same result as 
including parameter OPTCD=J· in the JCL. 


The CONTROL-D OBTPARMS library is used to implement global control of printing 
characteristics. Each member in the OUTPARMS lib11ary refers to a job name (e.g., the 
member name is the job 1 name), 011 each member refers to a user ID. All member names 
must either refer to job names or to user IDs - the two cannot be mixed. The members 
contain the pl'inting characteristics that will be used for the reports. In addition, a special 
member named $$BANCHR is referred to for printing characteristics of banners (described 
later in this section). 
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Refer to· the sample members in this library for details on1 how to specify the printing 
characteristics o£the reports and, banners produced by CONTROL-D. 


Note 
Reponts which are not specified in the OUTPARMS libnary will pnint with the 
default characteristics specified in the decollating mission or taken from the 
Permanent User file; 


As an 
1 example of how this option, can be used, the user can send all the reports that belong 
to the accounting department to the local printer at the accounting department. 


To control the pl1inting characteristics of repo11ts add' parameters OUTP ARM and BANNER 
to the banner exits (CTDX003 and CTDX014) im the IOA SECUDATA libra11y. (See 
"OUTPARM Support" in Section: 10 of this guide for more information on these 
pal'ameters.) 


To control: the printing characteristics 0£ banners, follow these steps: 


1. Refer to the sample member SAMPBANN in the OlJTP ARMS library for details on1 how to 
specify the printing characteristics that willl be used for banners. Alli printing characteristics 
listed above in1 "Using OBTPARM for Global Control of Printing Characteristics" can be 


used: 


Create member $$BANCHR in the O'C!JTPARMS library. This member is used to specify' the 
printing characteristics that willi be used for banners .. The follbwing is an, example of this 
member: 


+++STD* 


OtJTPt1ll.'=BANNER1 


In this example, an: printing missions whose names start With STD will! use the OBTPNT 


statement BANNER! to. determine the printing characteristics of; the banners. If an 
1 astel1isk 


is specified instead of STD *, all printing missions will: use O'C!JTPUT statement BANNER! 
to.determine the printing characteristics of banners. 


2. Add OUTPUT DD statement(s) to the CONTROl1-D Printers Control1 monitor procedure 
(CTDPRINT). For each OlJTPUT statement add the appropriate printing parameters 
(PAGEDEF, FORMDEF, etc.). For example, assume that member $$BANCHR contains the 
following lines:· 


+++STD* 


OUTPUT=BANNER1 


+++STD?G 


OUTPUT=BANNER2 


In this case, OUTPUT statements BANNER! and BANNER2 must be added to the 


CTDPRINT procedure. 


3. If the site runs more than' one Printers Control monitor (CTDPRIN2, etc.), these OlJTPl:JT 


statement(s) must be added each Printers Control1monitor procedure. 
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Printing to a File 


It is sometimes advantageous to direct output (a bundle) to a sequential file instead of to 
the printer. This function is suppol'ted under CONTROL-D using a supplied user exit 


(CTDX005) which is described in the following pages .. This capability will be implemented 
as a standard function of the CONTROL-D Printing Mission Definition screen in a future 
release of CONTROL-D. 


Activating the Facility 


There are two recommended methods to route output to a sequential file. The first allocates a 
new file using a dynamic filename; the second writes the output to an existing file. 


1. Allocating a New File 


Type SEQL-FILE in the CATEGORY field of the Printing Mission Definition· screen. A new 
dataset is created with the following dataset name format: 


prefix.mission-name.Dddmmyy.Thhmmss 


where prefix is the value assigned to CONTROL-D exit 5 parameter PREFIX. (See 


"Tailoring CTDX005".) Ifno value is assigned to this parameter, prefix defaults to CTDPRT. 


Note 
If a dataset name has been designated in the DSN parameter of CTDX005, then the 
name specified in the exit overrides the above default name. However, it is not 
recommended to specify a fixed name in the exit, since the user must then delete the 
file after using it to reallocate it the next time. 


2. Using an Existing File 


Type SEQL-filename in the CATEGORY field of the Printing Mission Definition screen. 
filename is the name (up to 15 · charactel's in length) of an: existing cataloged dataset. 


The exit will concatenate the output to the existing file (i.e., it will write the output at the 
end of the existing file) (DISP=MOD). This option ignores the default parameters of the 


CTDX005 exit and utilizes the characteristics of the existing file, affol'ding the user 
flexibility in specifying file characteristics. If the file does not exist, a new file is created 
(DISP=NEW) utilizing the macro default parameters (as in Option 1). 


Tailoring CTDX005 


Edit member CTDX005 in the IOA SECUDATA library. The following parameters related 
to printing to a file should be tailored to site requirements. Following the parameter list is 
a description of the parametel's. 


C'l'DUXOOS 
UNI'l'=SYSDA, 


DSN=, 
PREFlX=, 


PRIVA'l'E=NO, 
VOLCN'I'=, 


VOL1=XXXXXX, 


VOL2=, 


LABEL=, 
SPACE'l'Y=, 
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PIUMARY=20, 
SECOND=, 
RLSE=, 
DEFER=, 


DEN=, 


LRECL=l33, 
BLKSI:ZE=l3301 
RECFM=FBA, 


ROLER=NO, 


DUMMY=NO, 
FOB=NO, 


EXPM=, 


TR'l'CH= 


Parameters of Exit CTDX005 


UNIT 


DSN 


PREFIX 


PRIVATE 


VOI:.CNT 


VOL! 


VOI:.2 


LABEL 


SPACETY 


PRIMARY 


SECOND 


RLSE 


DEFER 


DEN 


LRECL 


BLKSIZE 


RECFM 
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Unit type - e.g., TAPE, 3380 (default is SYSDA). 


Dataset name for the sequential file (used when the CATAGORY field of 
the printing mission Definition' does not specify a dataset name in a 


SEQL= string). See the note included in option' 1 ("Allocating a New File" 


above): 


The default prefix of the sequential file name (the first qualifier in the 
dataset name). 1-7 characters in length. 


YES 


NO 


The file will! be written to a specified volume. Default. 


The file will be written to a "scratch~ tape. 


Maximum number of tape volumes to output dataset will require; used in 
conjunction with the PRIVATE= YES parameter. 


First volume serial number. 


Second volume serial number. Optional. 


Label type (SL, NL, NSL, AL, AUL, StJL, or: BLP) for tape specification 
(the default is SL). 


Allt>cationtype - CYL or TRK (the default is TRK). 


Primary space allocation (the default is 20). 


Secondary space allocation (the default is 0). 


Unused space release specification. 


Deferred mounting specification. 


Tape density- 1600/6250 (the default is 6250). 


Maximum logical record length(the default is 203). 


Maximum block size (the default is 4060). 


Reco11d format (the default is FB). 
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DUMMY 


FOB 


RULER 


EXPDT 


TRTCH 


NO 


YES 


NO 


YES 


NO 


YES 


yyddd. 


COMP 


NOCOMP 


The exit will be used to create a sequential file. Default. 


The exit will! not create a sequential file. It can be used for 
other special1 processing. 


FOB printers (see "Siemens Printer Support" in the IOA 


Installation guide) are not supported. 


FOB printers (see "Siemens Printer Support") are 
supported. 


Write the report to a sequential file without the ruler. 


Write the report to a sequential file with the ruler. 


File expiration date. 


Use compression mode when writing to cartridges. 


Write without compression. 


Backup Mission Management 


Overview 


Aspects of managing backup missions are explained under the following topics: 


• Advanced Scheduling Issues 


- 
Backup According to Scheduling Dates 


- 
Report Decollating and Backup Mission Dependency 


• Backup mission Workflow 


- 
Exception Handling 


• Changing Backup Mission Retention Period 


Advanced Scheduling Issues 


Backup According to Scheduling Dates 


It is possible to 011ganize backup missions in such a way that each day's backup 
management (i.e., the backup workflow) is the same. The simplest solution is to specify 


DAYS=ALL in the Basic Scheduling parameters of! all the backup missions. Once a day, 
when the backup mission Daily procedure is invoked, all backup missions scheduled for 
the coming 24 hours are placed on the Active Missions file. 


This backup organization does not maximize the capabilities of CONTROI:.-D. You can 
organize the backup order in different ways fo11 different days (e.g., a regular day, the end of 
the week, the end of the month, holidays). Via CONTROL-D it is possible to define several 
copies of the same backup mission, Each copy is an independent definition of the backup 
mission and should have different scheduling criteria, different runtime criteria, etc; 
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Example 


Backup mission BKP0031D will start not later than: 06:00 on every workday, will start not 
later than 05i00 at the end of the month, and win not be scheduled, for holidays. Since there 
is no limit to· the number of backup missions which can be defmed, the user can organize the 
backup process to optimally suit every p:rioduction' day ofi the yea:ri. 


Report Decollating and Backup Mission Dependency 


It is recommended to establish dependency between the successful decollation 0£ reports 
and the backup. process (by CONTROI:.-D backup missions). The dependency can be 
established: using the prerequisite condition· concept.. Parameter OUT of the report 
decollating mission should specify a p11erequisite condition that will be referenced by 
parameter IN of the backup mission, Using this method; backup occurs only when all the 
reports which should be backed up together have been decollated. 


It is possible to define different report-backup dependencies for different scheduling dates 
(e.g., regular dates vs .. end of the month). This can1 be done, as described above, by using 
multiple copies ofi the same backup mission, each: one distinguished: by different basic 
scheduling criteria and different runtime scheduling criteria (prerequisite conditions, 
time, p:riiority, etc;). 


Report 
Processing 
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Backup Mission Workflow 


The backup mission, work.flow of CONTROL-Dis shown below. It illustrates the stages involved 
from initially scheduling the backup mission' tlwough backing up the CDAM datasets. 


The workflow of a backup mission is: 


BACKUP 


MISSION 


LIBRARY 


EXECUTE 


• The Active User Report List file is scanned by the CONTROl!..-D monitor for all reports 
requiring backup by the specified backup mission name. (This is a fast scan, not a scan 0£ 


the entire file.) Repoms which have been previously backed up, or have been restored from a 
backup, are not backed up a second time .. The result of this process is a list of dataset names 
to be backed up. 


• The CONTROL-D monitor reads a skeletonjob from the library referenced by DB statement 
DADSKL of the CONTROL-D monitor. The member name must be the same as the backup 
mission name (e.g., BKP0031D). 


Note 
Since the same library· is used for migration, backup and restore mission skeletons, 
the name of each mission must be unique. 
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When you define a new backup mission, you must create a new skeletonjob with the same 
name. 


The member must contain certain: parameters which are interpreted by the CONTROL-D 


monitor. The parameters are: 


%DSNS% 
Resolves into a list of aU the dataset names that have to be backed up. 
This list is in DF/r>SS, DF/FISM, FDR, DMS/OS, ASM2 or ARCS 


format depending on installation pwameters. Mandatory. 


%TIMESTMP% 
Resolves into atimestamp, which is later used by CONTROL-D for 
internal purposes. Mandatory. 


%MISSNAME% 
Resolves into the backup mission name. Mandatory. 


%COND% cond~name When the preparationofthe backupjobis completed, the specified 
condition 
1name is added to the IOA Conditions/Resources file. The 


ODAT of the condition is identical to the original scheduling date of 
the backup.mission, This can be used for triggering the backup job 
under CONTROI:..-M. OptionaL 


• When CONTROL-D finishes preparing the member for submission1 control is passed to exit 


CTDXOlO. This exit can modify the contents of the submitted job (by adding, deleting or 


modifying the JCI:.). Fo11 example, it is possible to use a fo:rnnat different from the DF/DSS, 
DF/FISM, FDR, DMS/OS, ASM2 or ARCS format fo11 the dataset names list. The exit can 
return the following return codes: 


0 
Submit the job; 


4 
Do not submit the job (no:rnnally used when the submission is to be executed by a 
production control system). 


• The member is written to the library referenced by DD statement DADJOB of the 


CONTROL-D monitor with a name identical to the name of the backup mission, Therefore, 
this library must be different from the library referenced by DID statement DADSKL. 


Depending on the return' codes from: the user exit, the job is, or is not, submitted~ If 


CONTROI:.-M is installed, submission of the job can be triggered by the %COND% 


statement. (The advantage of this method is that ove11all p11oduction tape wo11kload and, tape 
usage priority are taken into consideration when submitting the backup job,) 


• The original member supplied contains two steps: 


- 
The DF/DSS, DF/FISM, FDR, DMS/OS, ASM2 or ARCS backup utility. 


- 
A program which analyzes the output of the backup p11ocess and' updates CONTROI!..-D 


files with the results (e.g.,. the tape numbers used). 


• When the job finishes executing, the CONTROI!,-D monitor is notified (by the second step) 
andthe backup mission's post-processing parameters (OBT andSHOBT) are processed. 
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Exception Handling 


If the backup job abends in the first step (BACKUP), the status of the backup mission is 
changed. to ENDED-NOTOK. When this happens, check why the abend occurred and 


co11rect the problem .. After the p11oblem1 has been covrected, revun the backup mission from 
the Active Missions file. 


If the backup job abends during the second step (ANALYZE), the status of the backup 
mission remains BACKUP IN PROCESS. When this happens reset the backup mission 
status to ENDED viajobBKPRESET in the CONTROL-D JCL library. 


If the backup mission ended NOTOK because one 011 more CDAM files were not backed up 
successfully, reorder the mission1 to back up only the CDAM files which were not backup 
up successfully during the pvevious run .. Rerunning the same mission, (without reordering 
it) reprocesses aU CDAM files of the previous run (including files which were successfully 
backed up). 


Changing Backup Mission Retention Period 


Backup missions use the following parameters to specify the retention peviod of a backed 
up CDAM file: 


# OF DAYS TO KEEP 
This specifies how many days should pass from the backup 
date to the expivation: date. 


# OF GENERATIONS TO KEEP Specifies how many generations (executions) of the backup 
mission should pass until the generation expires. 


These parameters are specified in the backup mission definition screen. If there is a need 
to change from# OF GENERATIONS TO KEEP method to # OF DAYS TO KEEP method, 
a new backup mission should be used, (e.g., the DO BACKUP statement in the Decollation 


definition mission should refer to a new backup mission name). If the same backup mission 
is used~ an error message will appear and the backup mission will end NOTOK. 


Migration Mission Management (CONTROL-V) 


Overview 


Various aspects of managing migration missions are explained under the following topics: 


• Advanced Scheduling Issues 


- 
Distribution According to Scheduling Dates 


- 
Report Decollating and Migration, Mission Dependency 


• Migration Mission Workflow 


- 
Exception· Handling 
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Advanced Scheduling Issues 


Distribution According to Scheduling Dates 


It is possible to organize migration missions in1 such a way that each day's migration 
management (i.e., the migration workflow) is the same. The simplest solution is to specify 
DAYS=ALL in 
1 the Basic Scheduling parameters 0£ aH migration missions. Once a day, 
when the migration missions Daily procedure is invoked, alt migration missions scheduled 
for the coming 24 hours are placed on the Active Missions file. 


This migration origanization does not maximize the capabilities of CONTROL-V. You can 


origanize the migration orider in, different ways for different days (e.g., a regular day, the 
end of the week) the end of the month, holidays) .. Using CONTROL-V it is possible to 
define several copies of the same migration' mission. Each copy is an independent 
definition: 0£ the migration mission' and should have different scheduling criteria, (e.g., 
different runtime criteria). 


Since there is no· limit to· the number of migration 1 missions which can be defined, the user 
can organize the migration1 process to optimally suit every production' day 0£ the year. 


Report Decollating and Migration Mission Dependency 


It is recommended to establish dependency between the successful decollation of reports 
and the migration priocess by CONTROL-V migration missions. The dependency can be 
established using the prierequisite condition concept. Parameter OUT of the report 
decollating mission should specify a prierequisite condition that wiU be referenced by 
parameter IN 0£ the migration, mission• Using this method, migration occurs only when 
1 all 
the reports which should migrate together have been1 decollated. 


It is possible to define different decollation.-migration, dependencies for different 
scheduling dates (e.g., regular dates vs .. end .. of-month~. This can be done, as described 
above, by using multiple copies of the same migration mission, each, one distinguished by 
different basic scheduling criteria and different runtime scheduling criteria (prerequisite 
conditions, time, prioriity, etc.). 


Migration Mission Workflow 


The worikflow of a migration missioni is:• 


• The Active User Report List file is scanned by the CONTROL-DN monitor for alll reports 
requiring migration by the specified 
1 migration mission name .. (This is a fast scan, not a scan 
of the entire file.) Reports which have previously migrated axe not migrated a second time. 
The result of this priocess is a list of datasets to be migrated. 


• The CONTROL-DN monitor reads a skeleton job from. the libriary referenced by DD 


statement DADSKL of the CONTROL-DN monitori. The member name must be the same as 
the migration mission1name (e.g~, MIG0007Y). 


Note 
Since the same library is usedfor migration,. backup and restore mission skeletons, 
the names of the missions· must be unique. 
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When you define a new migration mission) you must create a new skeleton job (member) 
with the same name. 


The skeleton job must contain certain parameters which are interpreted by the 


CONTROL-DN monitor. The parameters are: 


%DSNS% 
Resolves into a list 0£ aUthe datasets that have to·migrate. Mandatory. 


Used as input to the MIGRAT step. 


%TIMESTMP% 
Resolves into a timestamp which is later used by CONTROL-V for 
internal purposes. Mandatory. Used as input to the ANALYZE step. 


%MISSNAME% 
Resolves into the migration mission' name. Used as input to the 


ANALYZE step .. Mandatocy. 


%COND% cond-name When the preparation o£the migration job is completed, the specified 
condition is added to the IOA Conditions/Resources file. The ODAT 


of the condition, is identical to the original scheduling date of the 
migration mission. This can be used for triggering the migration job 
under CONTROL-M .. Optional. 
• When the CONTROL-DN monitor finishes p11eparing the member fo11 submission, control is 
passed to user exit CTDXOlO. This exit can modify the contents of the submitted job by 
adding, deleting· or modifying the JCI:,. This exit can return the following return codes: 


0 Submit the job: 


4 Do not submit the job (normally used when the submission is to be executed by a 


p11oduction control1 system). 


• The member is written to the library referenced by DD statement DADJQB of the 


CONTROL-DN monitor with a name identical to the name of the migration mission. 
Therefore, this library must be different from the library referenced by DD statement 


DADSKL. Depending on the return codes from: the user exit, the job is, or is not submitted. 
If CONTROb-M is installed, submission of the job can be triggered by the %COND% 


statement. 


• When the job finishes executing, the CONTROL-DN monitor is notified by the ANALYZE 


step and the migration mission's post-processing parameters (ONT and SHOBT) are 
processed. 


Report 
Processing 
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Dual Migration 


If the yes/no field in migration mission parameter SECONDARY is set to Y, the migration 
mission submits two migrationjobs: 


• The primary migration 1 job uses the migration, skeleton whose name is identical to the 
migration mission name .. Parameter %LEVEL% is set to PRIMARY in the migration step 
and analyze step of this job. All migrated files created by this job have the prefix specified in 
media definition' parameter DSNPREF. 


• The secondary migration job uses the migration skeleton whose name is specified in name 
field. of parameter SECONDARY. Parameter %LEVEL% is set to SECONDARY in the 
migration, step and analyze step of this job. All migrated files created by this job have the 
prefix specified in' media definition pwameter SECPREF. See "Media Specific Parameters" 
in Section 6 of the IOA Installa.tion1 Guide for mo11e information' about parameters 


DSNPREF and SECPREF. 


See Section 4 of the CONTROL-V User Manual foll molle information about parameter 


SECONDARY. 


By default, the pl'imary migrated files accessed for viewing. Utility CT:DUPBKP can be 
used to switch primary and secondary media information .. After running the utility, the 
secondary migrated files are accessed for viewing. This utility can be run again to switch 
back to viewing the primary migrated files .. 


Information about the current migration media can be displayed in $SYSDATA long 


follmat by using option' A (Additional Info) in the Migrated Repollt list. 


If a dual migration mission is rerun, both migration jobs wiU be resubmitted. However, if a 
migration job ended OK, the files migrated by that job will not migrate· again. To. re-migrate 
such files, the usel' must UNCATALG the migrated repollts before rerunning the migration 
mission. 


Both the primal'y and secondary CDAM and index files alle kept for the retention period 
defined in the migration mission' definition. Retention information' can be displayed in the 


$SYSDATA long format. 


Migration Media Definition 


Each site may utilize any or all of the supported types of migration target media. 
Media-specific parameters (NAME, TYPE, DSNPREF, UNITNAME, DEV ADDR, etc.) must 
be defined in member IOASPARM in the IOA INSTCTV lib11ary fo11 each migration target 
media type (including DASD) that will be used. See "Installing CONTROL-V" in the IOA 


Installation Guide foll details about these parameters .. 


The skeleton job foll each migration mission specifies the migration target media. See 
"Migration 
1 Mission Skeletons". 
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Cartridge (CART) Media Management 


When, migrating to media type CART, the migration process starts a new scratch volume 
for every run, The migration pvocess places as many files as possible on the same volume. 


Before writing each file, the migration process determines if the file will fit on' the volume 
(based on the CART media capacity parameter CARTLEN specified in member 


IOASPARM). If the file will not fit, a new scratch volume is used. If the file is larger than 
the specified volume capacity, the migration process uses a new volume for that file and 
then uses as many volumes as needed (a maximum of five volumes). 


Miscalculating the remaining space (e.g., if the specific volume was shorter or the 
compression factor was lower than expected), may cause the file to span more than one 
volume. This can result in slower retrieval response time. 


Migration Mission Skeletons 


In the CONTROL-D SKL library there is a skeleton member for each of the following 
migration media types: 


CART 


DASD 


oss 


FTK 


3480/3490/3490E Tape Cartridge. 


Disks (e.g., 3380, 3390, fat-DASD 3390-9 or IBM 3995 Optical Library 
Dataserver model 153). 


Kodak OPTISTAR Storage System (or compatible, e.g,, Data Ware OSS). 


FileTek Storage Machine (SM). 


All migration skeletons contain the following steps: 


MI GRAT 


ANALYZE 


Performs the migration. 


Runs a program which analyzes the output 0£ the migration step and 
updates CONTROL-DN files with the results. 


The OSS migration skeleton contains the following additional steps which precede the 
steps describe above: 


SRVD 


OSSDBEXT 


Shuts down the OSS device in the IOA Online monitor to coovdinate with 
the migration job. 


Creates the OSS Extract Dataset with information from the OSS 


Database. 


Each migration mission must have a unique name and its own skeleton job; When you 
define a new migration mission, copy an appropriate existing skeleton and give it the same 
name as the new migration mission, 


Migration to OSS 


The EXEC statement in the OSS migration skeleton's SRVD and MIGRAT steps contains 


PARM='OSS'. Change OSS to the logical name of the target media specified in member 


IOASFARM in the IOA INSTCTVlibrary. 
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In the OSSDBEXT step, specify the tape name (VOLSER) 0£ the OSS Database in 
parameter OSSDBVL. 


The EXEC statement in, the OSS migration skeleton's MIGRAT step contains 


PARM='OSS,NOCHECK'. It is recommended that you change NOCHECK to, the p:vefix 0£ a 
set of platters to whichr the reports should migrate. Meaningful prefixes should be used to 
create sets 0£ platters containing repo:vts with similar characteristics (e.g., viewed 
together, viewed with similar frequencies, viewed by same group of users). If the default 


NOCHECK is not changed, the report migrates to the first available platter. 


DD statement SORTIN of the OSS migration1 skeleton's MIGRAT step must point to the 


OSS Extract Database fo:v the media to which the reports should migrate. Use the name 
specified in, member IOASPARM in the IOA INSTCTV library for the approp:viate media. 
Change this parameter as required for migrating to various media. 


Migration to Cartridge 


The EXEC statement in the cartridge migration skeleton's MIGRAT step contains 


PARM='CART,NOCHECK'. Change CART to the logical name of the target media specified 
in' member IOASPARM in the IOA INSTCTV lib:vary. Do not change the NOCHECK in this 


skeleton, 


Migration to Disk, Fat-DASD, IBM 3995 Optical Library Dataserver 


The EXEC statement in the DISK migration skeleton's MIGRAT step contains 


PARM='DISK,NOCHECK'. It is recommended that you change NOCHECK to the prefix of 
a set ofVOLSERs to which the reports should migrate. Meaningful prefixes should, be used 
to create sets of volumes containing repo:vts with similar characteristics (e.g., viewed 
together, viewed with similar frequencies, viewed by same group of users). If the default 


NOCHECK is not changed, the repo:vt migrates to the first available VOLSER that belongs 
to the MVS UNIT specified in the media definition. 


Migration to FileTek Storage Machine 


The EXEC statement inithe·FTK skeleton's migrate step contains PARM='FTKl,NOCHECK'. 


Change FTKl to the logical name of the target media specified in' member IOASFARM in 


IOA INSTCTV libra:vy. Do not change the NOCHECK in, this skeleton. 


The follbwing parameters must be specified in1 the FTKIN sysin file: 


VSET 


FSET 


Volume Set of the Storage Machine to be used fo:v the migration mission. 


File Set of the Storage Machine to be used for the migration1 mission. 


Both paramete:vs must begin in, column L No blanks are allowed. 


Refer to the FileTek Storage Machine Documentation' fo:v info:vmation on how to determine 
the Volume Set and File Set. 


If sepa:vate VSET and FSET values need to be specified for different groups of users,. define 
a separate migration mission for each group: 
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Exception Handling 


If the migration: job abends in the MIGRAT step, rerun the job (either enter the JOB 


library and submit it, or if scheduled under CONTROL-M, use the CONTROL-M rerun 
option without restart). 


If the migration job abends in the ANALYZE step, rerun the job from the first step (i.e., 
submit it again without restart). 


If the ANALYZE step abends, the status of the migration mission remains MIGRATE IN 


PROCESS. To reset the migration mission status to ENDED, run the migration job from 
the ANALYZE step but change DD statement SYSIN to DUMMY. Sample job MIG RESET 
(which resets the migration mission) is in the JCL library. 


If the migration mission ended NOTOK because one or more CDAM files did not migrate 
successfully, rerunning the same mission (without reordering it) reprocesses all the CDAM files 
of the previous run (including files which migrated successfully) .. Reordering the mission 
migrates only the CDAM files which did not migrate successfully during the previous run. 


Rerunning a partially run1 migration job does not create duplicate copies 0£ files on the 
target media .. The migration job verifies that each file is cataloged (with the appropriate 
migration prefix). When running a previously ran cartridge migration job, data is not 
available for relative to absolute address conversion .. To properly regenerate the data, 
uncatalog the file on the target media (cataloged by the previous run), and completely 
rerun the migration 1job. 


Restore Mission Management 


Overview 


Various aspects of managing restore missions are explained under the following topics: 


• Advanced Scheduling Issues: 


- 
Restoring According to Scheduling Dates 


• Restore Mission Workflow 


• Exception Handling 


• Restoring with the Original Backup Utility 


Advanced Scheduling Issues 


Restoring According to Scheduling Dates 


It is possible to organize restore missions in such a way that each day's restore 
management (i.e., the restore workflow) is the same. The simplest method is to specify 
DAYS=ALL in the Basic Scheduling parameters 0£ all the restore missions. Once a day, 
when the restore mission Daily procedure is invoked, all restore missions scheduled for the 
coming 24 hours are placed on the Active Missions file. 
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This restore organization does not maximize the capabilities of CONTROL-D. You can 011ganize 


the restore order in' different ways fol' different days (e.g., a regula11 day, the end 0£ the week, 
the end of the month, holidays). Using CONTROL-D, it is possible to define several copies 0£ 


the same resto11e mission, Each copy is an independent definition of the restore mission and 
should have different scheduling criteria~ different runtime criteria, etc; 


Example 


The RSTNOON restore mission 1 will start not later than' 12:00 on every workday, will start 
not later than 
1 11:00 at the end 0£ the week, and will not be scheduled fo11 holidays. Since 
there is no limit to the number of restore missions which can be defmed, the user can 
organize the restore p11ocess to optimally suit every production1 day of the year. 


Restore Mission Workflow 


The restore mission, wo11k.flow ofi CONTROL-D is shown1 below. It shows the stages involved 


from initially scheduling the resto11e mission through, restoiiing the ODAM datasets. 


The workflow of a restore mission is:. 


RESTORE 


MISSION 
LIBRARY 


@ 
EXECITffi 


• The History User Report List file is scanned by the CONTROL-D monitor fo11 all reports 
which need to be restored by the specified, restore mission name. (This is a fast scan, not a 
scan of the entire file.) Resto11e is requested by online users via option R of the Histoey 


Report List screen1 The result of this process is a list of dataset names to be restored. 
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• The CONTROL-D monitor reads a skeleton job from the library referenced by DD statement 


DADSKL of the CONTROL-D monitor. The member name must be the same as the restore 
mission, name (e.g., RST0060M). 


Note 
Since the same library is used for migration, backup and restore mission skeletons, 
the names of the missions must be unique. 


When you define a new restore mission, you must create a new skeleton job with the 
same name. 


• The member must contain certain parameters which are interpreted by the CONTROL-D 


monitor. The parameters are: 


%REPEAT% 
Beginning/end. of a repeating step; Mandatocy. Since outputs can be 
%ENDREPEAT% 
backed up on' many volumes, it is sometimes necessary (with 


certain: archiving products) to perfol1ll1 the restore by more than one 


step. The definition, of this repeating step is found between the 


%REPEAT% and, %ENDREPEAT% statements (not applicable to 


DF/HSM, DMS/OS, ASM2 or ARCS fo!1ll1ats). 


%DSNS% 


%VOL.UMES% 


%TIMESTMP% 


Resolves into· a list of aU the dataset names that have to be 


restored~ This list is in, DF/DSS, DF/HSM, FDR, DMS/OS, ASM2, or 


ARCS fol1ll1at, depending on installation parameters. Mandatory. 


Resolves into the volume serial numbers of the tapes taking part in 
the restore. Mandatory (applies to DF/DSS or FDR formats). 


Resolves into, a timestamp which is later used by CONTROL-D for 
internal purposes. Mandatory. 


%MISSNAME% 
Resolves into the restore mission name. Mandatory. 


%COND% cond~name When the preparation of the restore job has been completed, the 
specified condition name is added to the IOA Conditions/Resources 
file. The ODAT of the condition is identical to the original 


schedulfug date of the restore mission. This can be used for 
triggering the restore job under CONTROL-M. OptionaL 


%BKPUTIL% 
Resolves into the backup utility name. OptionaL 


The value of this parameter is determined in the following manner: 


- 
The skeleton' member is searched fol' the BKPl'.JTIL assignment 


(e.g~, BKPUTIL=HSM). The value assigned for this parameter is 
referred to as the backup utility name. 


- 
If BKPl'.JTIL is not set in the skeleton' member, the value is 
taken from installation parameter BKPBTIL (in member 


CTDPARMin the IOA INSTCTD library). 


Note 
By· default, all the sample skeleton members provided in 
the CONTROL-D SKL library already have the BKPUTIL 


parameter assigned with the appropriate backup·utility. 


See "Restoring with the Original, Backup Utility" later for details on 
how to use this parameter. 
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• When CONTROL-D finishes preparing the member for submission, control' is passed to user 
exit CTI:>XOll. This exit can modify the contents of: the submitted job (by adding,.deleting or 
modifying the JCL). For example, it is possible to use a format different from the DF/DSS, 


DF/HSM, FDR, DMS/OS, ASM2 or ARCS format for the dataset names list. The exit can 
return the following return codes: 


0 
Submit the job. 


4 
Do not submit the job (normally used when' the submission is to be executed by a 
production control system). 


• The member is written, to the library referenced by DD statement DADJOB of the 


CONTROL-D monitor, with a name identicalito the name of the restore mission. Therefore, 
this lib11ary must be different from the library referenced by DD statement DADSKL. 
Depending on the return, codes from the user exit, the job is, or is not, submitted~ If 


CONTROL-M is installed, submission of the job can be triggered by the %COND% 


statement. (The advantage is that overall production tape wo:vk.load and tape usage priority 


are taken' into consideration when submitting the restore job.) 


The original member supplied is divided, intoz 


- 
The DF/fiSS, DF/HSM, FDR, DMS/08, ASM2 or ARCS restore utility. A step is created 


fo:v each group of tapes (VOI:..SERs) containing reports to be restored (not with all' 
products). 


- 
A program which analyzes the output of the restore process and updates CONTROL-D 


with the results. 


This step copies the restored user/report entries from the History User Report List file to 
the Active User Report List file and indicates that a restore has been performed. 


• When the job finishes executing, the CONTROL-D monitor is notified' (by the second step) 
and the restore mission's post-processing parameters (OUT and SHOUT) are processed. 


Exception Handling 


If the restore job abends in one of the first steps (such as the RESTORE step), rerun the 
job (enter the CONTROL-D JCL library and submit it or if scheduled under CONTROL-M, 


use the CONTROL-M rerun option without restart). 


If the restol'e job abends in' the last step (ANALYZE), rerun 1 the job from the last step (i.e., 
submit it again without restart). 


If the last step abends, the status of the restore mission remains RESTORE IN PROCESS. 


To reset the restore mission status to ENDED, run job, RSTRESET (which resets the 
restol'e mission) from the CONTROL-D JOB libra11y. In addition, all the restore requests 
should be performed again (using option, R in screen U, in the History User Report List file). 
The restore mission finishes with ENDED NOTOK status . 
. 
. 
Restoring With the Original Backup Utility 


Sites which are moving from one backup utility to another (e.g., from FDR to DF/HSM.) 
might end up having CDAM files which are backed up by different backup utilities. Each 
of the backed up CDAM files should be restored using the original backup utility. 
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To restore the CDAM file with the appropriate backup utility, the restore mission name 
should point to a skeleton member of the original backup utility. Parameter BKPUTl'L in 
the skeleton member should be set to the original backup utility name. 


Example 


II* 
BKPUT~L=FDRCAT 


This statement should appear in the skeleton member to use the FDR backup utility 


regardless of the value specified for BKPUTIL in member CTDP ARM in the IOA INSTCTD 


library. 


Note 
This overrides the value specified to BK.PUTIL in CONTROL-D installation parameter 
member CTDPARM in the IOA INSTCTD library. 


IOA Archive Server 


General 


The IOA Archive server enables online viewing and immediate printing of reports and 
indexes which have migrated to non-disk storage media• The server provides access to the 
following media types: 


CART 


DASD 


oss 


FTK 


3480/3490/3490E Tape Cartridge. 


Disks (e.g:, 3380, 3390, fat-DASL> 3390-9 or IBM 3995 Optical Library 
Dataserver model 153). 


Kodak OPTISTAR Storage System (or compatible, e.g., Data Ware OSS). 


FileTek Storage Machine (SM). 


There is no connection or dependency between the CONTRO'L-DN monitor and the IOA 


Archive server. Each can be brought up and down independently. 


Device Definition and Usage 


Cartridge (CART) Media Definition 


The cartridge devices defined in member IOASPARM in the INSTCTV library for media 
type CART can be used in the following two modes: 


• Dedicated 


• Dynamic 
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Dedicated Device Mode 


Dedicated devices are allocated to the server during the entire time the device is connected 
to the server. Devices can, be defined. explicitly by parameter DEVADDR, or implicitly by 
parameter DEVQTY. Devices can be connected (STARTed) or disconnected (STOPed) at 
any time using operator commands. 


When' using this mode, the number of devices available for the server is known. The 
response time for user requests can be predicted based on the server's workload. 


·Dynamic Device Mode 


Dynamic devices are allocated to the server when' needed, and freed when, no, requests are 
pending. Dynamic devices are defined' implicitly by parameter DEVQTY. This parameter 
defines the maximum number of devices that are allocated when the server is started. The 
allocation' is done upon, request. No· device is allocated until the first access is issued by an 
online viewing user. Pa!lameter DYNDEVRLSE defines when the device will be freed after 
requests have been processed: 


DYNDEVRLSE=(method,idletime) 


Where: 


method 


idletime 


SWITCF.I or NOSWITCF.I. Indicates whether to free the device when a 
request for another volume is to be processed (SWITCH), or to process 
requests for all volumes before releasing the device (NOSWITCH). Setting 


this parameter to· SWITCH may cause a device to· be released and 
allocated to another job when there are still requests pending. 


Number of minutes to hold' the device after the last request is processed~ 


This parameter enswes that if a request is issued within. the specified 
time interval~ the device will stiU be available to· the server. This 
parameter applies to,both SWITCH and NOSWITCN methods. 


KODAK/DataWare OSS Usage 


Updating the OSS Database 


Before updating the OSS database by adding/deleting virtual tapes or importing/expo1lting 


platters, stop. the IOA Archive Server or the appropriate media ini the IOA Archive Server. 


When the update is complete, run job 1 LOD@SSDB from the IOA INSTCTV library to create 
the OSS Extract Dataset file. After this job co~pletes, reactivate the IOA Archive Server 


or, if only the media was stopped, restart the media. 


FileTek Storage Machine Media Definition 


CONTROL-V communicates with the FileTek Storage machine via an application 
interface. 


The Resources (devices) defined in IOASPARM for media type FTK are logical devices. A 
logical device task is activated whenever a request is made to access a dataset that is not 
already being handled by another logical device. Each device task handles only one dataset 
at a time. 
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FTK Media Definition 


A special set of parameters is used to define FTK media during the CONTROL-V 


installation. Valid parameters are: 


MAXCONN 


SMNAME 


SUB SYS 


ACCOBNT 


PASSWORD 


GROtJP 


GROBPPWD 


Maximum number of logical1 devices that can, be active at any one time for 
the media. Each logical, device opens a session with the Storage Machine 
(SM). See the· documentation supplied with the FileTek Storage machine 
for information on 
1 how to determine an appropriate number of maximum 
sessions for the media. 


Note 
If more than one media has been defined for the same SM, you 
must verity that sum of the values specified for parameter 


MAX.CONN in all media definitions for the SM does not exceed 
the maximum number of sessions that the SM can support. 


Name of the FileTek Medfa being defined. 


Name of the FileTek Host Sto11age Machine subsystem. 


Storage Machine Account ID used by CONTROI:.-V to open a session with 
the FileTek SM. 


Password for the specified ACCO"CJNT. 


An Access Group name for files migrated to this media. 


Used to speci~ passwords for access to files in' the specified GROUP. 
Sepavate passwords can be specified for READ, WRITE, and DELETE 
access of the files in the GROUP. 


Using the above parameters you can create several different definitions for FTK media. 
Some possible reasons for creating more than one definition for FTK media include: 


• You, have mo11e than one FileTek Storage Machine at your site. 


• You want to maintain several different groups of datasets on the same SM (e.g., with 
different passwords) .. To accomplish this, define the different FTK media with the same 
subsystem (SUBSYS) and sto11age-machine (SMNAME) name, but with different group 
names (GROl!JP) and group passwords (GROUPPWD). 


The parameters used fo11 FTK media definition' are described in detail in the CONTROL-V 


section, of the IOA Installation Guide. 


Media and Resource Control 


The use of: each media and resource defined to the IOA Archive Server can' be controlled 
using operator commands: 


• Each media with all its resources can be stopped and restarted. 


• Resou11ces (devices, sessions, etc.) can1 be connected to or disconnected from the IOA Archive 
Server. 
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Operator commands for media and resource control are described as follows: 


Media Control 


Each media defined to the JOA Archive Server can be stopped and restarted separately. 


To stop a media with all its resources, issue the operatol' command: 


F 
ZOASMON,STOP MED:IA=media-name 


When the media is stopped, an, appropriate message is displayed on the operatol' console. 


To start a media, issue the following operator command: 


F 
ZOASMON,START MED:IA=media-name 


When the media is ready to receive requests, an approp11iate message is displayed on the 
operator console .. 


Resource Control 


Resources and their usage differ by media type. 


OSS Media -KODAK/DataWare OPTISTAR Storage Subsystem 


The OSS works in 3480 emulation, and its resources are "3480" devices. The devices are 
referred to by device number. Each device defined to the JOA Archive Server can be 
stopped and restarted separately. 


To stop an OSS device, issue the operato11 command: 


F 
ZOASMON,STOP MED:IA=media-name,DEVZCE=device-number 


When a device stops, an app11opriate message is displayed on the operato11 console. 


To sta11t an OSS device, issue the operato11 command: 


F 
ZOASMON,START MED:IA=media-name,DEVZCE=device-number 


When a device is ready to p11ocess requests, an appropriate message will be displayed on 
the operator console. 


Note 
Before starting an OSS device, make sure that the device is online and ready in the 
system. 


CART Media · 3480/3490/3490E Tape Cartridge Subsystem 


The resources are actual 3480 devices .. Devices are referred to by device number, Ol' by 
specifying the quantity of devices and letting the JOA Archive Server decide which to use 
or free. Each device defined to the JOA Archive Server can, be stopped and restarted 
separately. 


To stop.a specific device, issue the following operator command: 


F 
ZOASMON,STOP MED:IA=media-name,DEVZCE=device-number 


When the device stops, an appropl'iate message is displayed on the operator console. 
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To start a specific device, issue the following operatov command: 


F 
IOASMON,START MEDll=media-name,DEVJ:CE=device-number 


Note 
Before starting a CART device, make sure that the device is online and ready in the 
system. 


This command can, be issued, only when' the devices are dedicated to the IOA Archive 
Server. If the devices are used dynamically, start a device by specifying device quantity. 
When the device is ready to· pvocess requests, an appropriate message is displayed on the 


operato:ri console. To stop one/some/all devices of a specific media, issue the operator 
command: 


F 
IOASMON1STOP MEDJ:A=media-name,DEVQTY=number/ALL 


where number can be any integer from 1 through 99: 


As each device is stopped, an appvopriate message is displayed on the operator console. 


To start one/some/all devices of a specific media, issue the operator command: 


F 
IOASMON,START MEDJ:A=media-name1DEVQTY=number/ALL 


where number can be any integer from 1 through 99. 


As each device becomes ready to process requests, an, approp:riiate message is displayed on 
the operator console. 


Note 
Before starting the devices, make sure enough devices are online and ready· in the 
system. 


FTK Media - FileTek Storage Machine (SM) 


The resources (devices) defined in, IOASPARM for media type FTK are logical devices. A 
logical device task is activated whenever a request is made to access a dataset that is not 
already being handled by another logical device. Each logical device handles only one 
dataset at a time .. 


Up to 100 logical devices can be activated at one time depending on the value specified for 


CONTROL-V installation parameter MAXCONN, and optionally, the maximum set via a 


START or STOP operato:ri command .. If more than MAXCONN requests were made 
concurrently, they will wait in a queue for an available logical device. 


Logical Device Status. 


Logical devices are each assigned one of the following statuses: 


The device is now processing a request for file access. 
ACTIVE/BUSY 


IDLE 
The device processed a request recently and is now waiting for another 
request. 


INACTIVE 
The device is not processing any requests .. 
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When1 a logical device finishes processing a request, it checks the DSN queue for the next 
request. If no request is found, the logical device enters the IDLE status. If no request is 
detected within a limited time period', the device is assigned a status of INACTIVE. 


Note 
If no requests are being processed and the number of usable devices is one or more, 
device number one retains a status of IDLE (i.e., its status will not be set to 
INACTIVE). 


Determining the Number of Usable Devices 


As mentioned above, the maximum number of devices is defined via installation parameter 
MAXCONN. 


You can, however, limit the number of devices to be used (usable devices) via the operator 
commands. 


To reduce the number of usable devices, issue the following operator command: 


F J:OASMON,STOP MEDJ:A=media-name,DEVQTY=num/ALL 


Where num is the number of logical devices to be brought down. num can be any integer 
from 1 through 100. 


The STOP command determines which devices should be stopped\ according to their 


statuses. 


• The specified number of INACTIVE devices are stopped. 


• If the number of devices to be stopped is greater than, the number of devices that are 
presently INACTIVE, IDLE devices are stopped as well. 


• If the number of devices to be stopped is greater than, the number of devices that are either 
INACTIVE or IDLE, BUSY/ACTIVE devices are stopped as well. 


BlJSY devices to be stopped complete the request they are processing, before they accept a 
status of INACTIVE. 


To increase the maximum number of devices, use the following operator command: 


F J:OASMON,START MEDJ:A=media-name,DEVQTY=num/ALL 


Where num is the number of logical devices to be brought up. num can' be any integer from 
1 through 100; 


Note 
The maximum set by the STAR.T command cannot be greater than the number 
specified for CONTROL-V installation parameter MAXCONN. 


Starting/Stopping a Specific Logical Device 


To stop a specific ACTIVE (or IDI:.E) device, issue the following operator command: 


F J:OASMON,STOP MEDJ:A=media-name,DEVJ:CE=device-number 


When the device is stopped, the maximum number of usable devices is reduced by 1, and 
an appropriate message is displayed on the operator console. 
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To start a specific INACTIVE device, issue the following operator command: 


F iOASMON,START MEDIA=media-name,DEViCE=device-numbe~ 


When the device is started, the maximum number of usable devices is increased by 1, and 
an appropriate message is displayed on1 the operato11 console. 


Note 
The maximum set by the START command cannot be greater than the number 
specified for CONTROL-V installation parameter MAXCONN. 


Since the devices defined fo11 the FTK type media are logical devices (i.e., not physical 
devices), starting or stopping any specific device has the same effect as using the DEVQTY 
parameter to increase/decrease the maximum number of usable devices by one. 


Displaying Media Information 


Information about a media can be displayed using the command: 


F 
iOASMON,DiSPLAY MEDIA=media-name 


The info11mation displayed as a result of this command includes media and resoul'ce 


information .. The media infovmation includes details such as: 


• Media type 


• System unit name/type to be used for this media 


• Number of pending requests 


• Type and number of resouvces 


Resource info11mationi varies by media type but includes details such as: 


• Device number 


• Device use type (DEDICATED/DYNAMIC) 


• Device status (ACTIVE/BUSY/INACTIVE/IDLE) 


• Details about the current process, if there is one (e.g.,.use11 ID, volser, or dsn) 


FTKMedia 


Resource information for FTK media includes: 


• Maximum number 0£ usable devices 


• Numbe11 0£ devices that are active (with a status of BUSY, ACTIVE, or IDLE) 


• Status (displayed fo11 each logical device) 


• User-ID and the name of the dataset being processed (displayed for each logical device) 


Devices that are no longer usable, or ave currently INACTIVE, are displayed on the 
console with a status of INACTIVE. 
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Problem Determination 


The IOA Archive Server is supplied with internal debugging facilities. Under no11mal 


circumstances, these facilities are do11mant. However, if required (e.g., your IOA 


representative requests debugging info:vmation), it is possible to activate the debugging 
facility as follows: 


1. The debugging level can be set when' starting the IOA A:vchive Server 011 during normal: 


operation, To sta:vt the debugging facility while starting the IOA Archive Server, use the 
following command: 


S 
IOASMON,DEBUG=level 


To start the debugging facility during operation, use the following command: 


F 
IOASMON,SET DEBUG=level 


The debugging level can, be any value from 0 (no debugging) to 255. The required debugging 
level, and instructions to set it with a START or MODIFY command~ will! be supplied by 


you11 IOA representative. 


When the IOA A:vchive Server debugging facility is successfully activated, the following 
message is displayed on the operator console: 


IOA128I 
IOASMON - 
DEBUG LEVEL IS SET TO level 


Note 
It is strongly recommended that you do not activate the JOA Archive Server with 
parameter DEBUG on a regular basis for the following reasons: 


• Spool utilization is greatly increased if a large amount of debugging information 
is generated: 


• In case of a JES problem, the JOA Archive Server may become suspended while 
waiting for JES. 


2. Debugging information is printed to DD statements PRTDBG and DADUMP 0£ the IOA 
A:vchive Server procedu11e. 


3. When p11oblem determination procedures are completed, turn off the debugging facility with 
the operator command: 


F 
IOASMON,SET DEBUG=O· 


When the IOA Archive Server debugging facility is successfully deactivated, the following 
message is displayed on the operator console: 


IOA128I IOASOM - 
DEBUG LEVEL IS SET TO 0 


User Report List File Management 


Overview 


The following User Report List files are contained in the CONTROL-D repository: 


• Permanent User Report List file 


• Active User Report List file 
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• Histo:ey User Repo:rt List file 


• Migrated User Report List file (CONTROI:,-V only) 


The contents of each file are described in detail. 


The files are managed by the IOA Access Method. Each file consists of two separate 
sequential datasets: 


• A Data component, where the actual record information resides. 


• An Index component, which provides keyed access to records in the Data component. 


Both Data and Index components may extend beyond one physical dataset (depending on 
whether or not automatic· extension was specified for the file during allocation). Initially, a 
component is allocated as a single physical dataset called the p11imary extent. 


See the explanation on' IOA Access Method in Section 2 of this guide for more information. 


The file naming convention is: 


prefix.dbname.En:nn 


where: 


prefix 


dbname 


Ennn 


Example 


Set to CONTROL-D installation parameter DBFREFD. 


Set to file identifier name, as follows: 


HST 


HSTI 


ACT 


ACTI' 


PRM 


PRMI 


MIG 


MIGi 


CONTROL-D History User Report list Data component. 


CONTROl;,-D History User Report list Index component. 


CONTROJ;,-D Active User Report list Data component. 


CONTROL-D Active User Report list Index component. 


CONTROL-D Permanent User Report list Data component. 


CONTROl!rD Permanent User Report list Index component. 


CONTROL,-V Migrated User Report list Data component. 


CONTROL-V Migrated Use11 Report list Index component. 


Extent sequence number suffix. The suffix consists of the letter E followed· by 


nnn, a number from 000 to 255, indicating the extent sequence number. 


If CONTROL-D installation parameter DBPREFD contains the value CTD, the following 
file names are assigned for the Active User Report file: 


CTD.ACT.EOOO 
For the Data component. 


CTD.ACTl.EOOO For the Index component. 
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Each component uses its own file definition. member which resides in the JOA INSTCTD 


library. The member includes the file's physical and logical attributes. The member name 
is DEFxxx foll a Data component, or DEFxxxl foll an Index component, where xxx is the 
dbname as described previously. The member is used by utility IOADBF. Additional, 
utilities are p11ovided to maintain these JOA Access Method files. See the Utilities section 
later in, this guide for molle details about these utilities. 


The files can be activated with dual (mirroll image) file support .. The dual file name is 
similar to the main file name, except for the suffix (Dnnn instead of Ennn~. The Dual file 
support can be defined for both the Data component and Index component. It is 
recommended: that this featm~e be activated only fo11 the Data component to reduce 
overhead, since the Index component can' be built from the Data component. 


See "CONTROL-D Repositolly Maintenance" later in, this section, for details about 
maintaining these files. 


Permanent User Report List File 


The Permanent User Repo:rrt List file can, be referred to as a repollt catalog. It contains, foll 


each usell, the list of reports the user (recipient) may receive at any time, their copy count 


(foll the user), the print destination (if it is not one of the main computer p:vinters such as 


LOCAL), and other information. 


The Permanent User Report list file is used by end users (recipients) to permanently 
define the numbe11 of (p11inted~ copies they want to receive from each report (in a given 
categolly), to request that the repollt is printed, on a local printer, to, assign a copy of the 
report to another user, and to permanently define other report list defaults. 


Once a day, the repollt list in the Permanent User Report List file can be copied, to the 
Active User Repo:rrt List file. The user, foll example, may change the copy count of his/her 


repo11ts on the Active User Repollt List file, but that change remains in1 effect only for that 
day. On the next day, the reports 0£ each user are copied again from the Permanent User 
Repollt List file to the Active User Repollt List file with the original (permanent) copy 
count. Using this simple method, the user can1 either set the copy count of a repollt 


permanently by modifying it in the Permanent User Repollt List file (using the Online 
Permanent User Report list screen), or temporarily modify it for a specific day in the 
Active User Repollt List file (using the Online Active User Repo11t List screen). AU other 
updatable fields (parameters) wovk the same way. 


There are two ways to access the data stoved in this file: 


• Using utility CTDCP2A 


• Using the decollation mission definition SEARCH parameter 


Utility CTDCP2A 


This utility is used to copy the list of repollts from the Permanent User Repo11t List file to 
the Active User Report List file. Newly-made changes to the Permanent User Report List 
file are then reflected, in the Active User Report list file. Each report copied to the Active 


User Repo:rrt List file has an original scheduling date associated with it. The 011iginal 


scheduling date is passed as a parameter to the utility. If the parameter is omitted, the 
date in the computer is used, (For more details, refer to Utility CTDCP2A in Section 9 of 
this guide.) 
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Running this utility more than once a day (e.g., after a computer crash) does not create 
duplicate entries. You can run this utility befor:e or after the New Day pr:ocedure. 


SEARCH Parameter 


This is the recommended method for: accessing the Permanent User Repor:t List file. By 
setting this parameter to P (SEARCH=P) in the report decollation mission definition, the 
relevant Permanent User Report List file entries are accessed during the decollation 


pr:ocess to retrieve the values of the repor:t parameters. See Section 3 of the CONTROL-D 


User Manual for a description of parameter SEARCH. 


Utility CTDCA2P 


Utility CTDCA2P copies newly generated report/user entries from the Active User Report 
List file to· the Permanent User Report List file (which maintains the list of all reports that 
can be created at any specific time). 


New report/user entries are created on the Active User Report List file when a new 
recipient is detected in a certain report (e.g., when a new bank branch is opened). This 
entry has the default copy count of the repor:t as defined in the report decollating mission. 
The utility copies the entries to the Permanent User Report List file, thereby 
automatically updating the User Repor:t list on the Permanent User Report List file. It 
does not update User/Report entries that already exist in' the Permanent User Report List 
file. 


Utility CTDCA2P can be run more than once a day (e.g., after a computer crash). Duplicate 
entries are not created. 


It is recommended, that the utility be run once a day, preferably befor:e the New Day 


procedui:e is invoked. 


Active User Report List File 


The Active User Repovt List file contains entries with the following repovt status: 


• Reports due to be decollated (in WAIT DECOLLATION status). These entries are created by 
utility CTDCP2A. 


- 
The user can change the copy count and print destination, 


- 
The user can add1 additional1 report recipients. 


• Repor:ts which are decolll:lted but are waiting to be bundle printed (in WAIT PRINT status): 


- 
The user can view the repor:ts. 


- 
The user can change the copy count, print destination and any other report 
characteristics. 


• Reports which ave decollated but will not be bundle printed (in DECOLLATED status): 


- 
The user can, view the repor:ts. 


- 
The user can request an· immediate print request. 
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• Reports whichhave been1printed(in1PRINTED or PRINTED-WAIT BKP status): 


- 
The user can view the reports. 


- 
The user can request an immediate print request. 


• CONTROI:.-V reports which are decollated but have not yet migrated away from DASD 
storage, or reports that have been migrated after the last run of utility CTDDELRP (i.e., 
reports in WAIT MIGRATE status): 


- 
The user can1view the reports. 


- 
The user can request an immediate print request. 


The Active User Repo11t list files may contain reports from more than one day. Therefore, 
these files can contain mo:rie than, one entry fo11 each report/recipient/category. Each entry 
is distinguished by its original scheduling date and its decollation date. 


Migrated User Report List File 


The CONTROL-V Migrated User Report List file contains a list of aU Migrated reports that 
have been deleted from DASLl. These repo:rits are in MIGRATED status. The user can: 


• View the reports. 


• Request an immediate print request. 


The user can1 request that the Active User Report List screen display reports from the 
Active User file only, from the Migrated User file only, or from both User Report List files. 


The Migrated User Report List files may contain repo11ts from mo11e than one day. 


Therefo11e, these files can contain more than one entry for each report/recipient/category. 
Each entry is distinguished by its 011iginal scheduling date and its decollation date. 


Utility CTVCLM.IG 


This CONTROL-V utility erases from the Migrated User Report List file all report entries 
for which, the retention period has expired (i.e., the number 0£ days that the repo11ts should 
be retained has passed). For relevant migrated media, the utility produces a list of tapes 
which can be freed for general use (i.e., returned. to the free tape pool~. 


Each repo11t copied to the Migrated User Repo11t List file has an' original scheduling date 
associated with it. 


This utility can' be run before 011 after the New Day p11ocedure and it can be run more than 
once a day (e.g., after a computer crash). 


This utility should be run' at least once a week 


For mo11e details, refer to the description of this utility in Section 9 of this guide. 
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History User Report List File 


The History User Report List file contains a list of all backed up reports that have been 
deleted, from the disk. The installation can control the time that the report will be retained 
in the Histol'y User Report List file. The file also contains details about the storage media 
of the report data (compressed dataset name on disk, or volsers o£tape or cartridge). 


To view a report, the user should issue a report restore request from the History User 
Report List file. When the report restore request is performed, the user report entry is 
copied from the History User Report List file to the Active User Report List file by the 
restore mission as soon, as the reporl is restored from tape to disk. 


Utility CTDDELRP 


CONTROL-D utility CTDBELRP scans the Active User Report List file for reports whose 
Active User Entry has expfred. For reports meeting the specified selection criteria, the 
following actions take place: 


• Reports for which a backup or migration has been requested but not performed are flagged 
as WAITING FOR BACKUP (or WAITING FOR MIGRATION). 


• The entry of each report fol' which backup and migration have been performed is moved 
from the Active User Report List file to the Migrated and the History User Report list files. 


The entry of each report for which only migration has been performed, is moved from the 
Active User Report List file to the Migrated User Report List file. 


The entry of each report for which only backup has been performed is moved from the Active 
to the History User Report List file. 


• A report entry that is not defined to be backed up or migrated is erased from the Active User 
Report List file. 


• When the Active User Report List file has no entries for a report the compressed dataset 
containing that report is el'ased from DASD storage (if it does not contain data of other 
reports not yet erased). 


Run, this utility at least once a day, preferably after all backups have finished. executing. 


See Section 9 of this guide fov more details regarding utility CTDDELRP. 


There is no harm in running utility CTDDELRP more than once a day (e.g., after a 
computer crash). You may run this utility befove or after the New Day procedure. 


Utility CTDCLHIS 


This utility erases from the History User Report List file all entries belonging to reports 
for which the backup period has expired (i.e., the number of days that the reports should 
be retained has passed~. The utility produces a list of tapes which can be freed for general 
use (i.e., returned to the free tape pooH. 


This utility can be run before or after the New Day procedure and it can be run more than 
once a day (e.g., after a computer crash). 


This utility should be run at least once a week. 


For more details, refer to Section1 9 of this guide. 
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Summary 


The following steps should be applied when1 maintaining various user files, usually on a 
daily basis: 


• Copy report definitions from the Permanent User Report List file to the Active User Report 
List file (utility CTDCP2A). 


• Copy the new user/report entries from the Active User Report List file to the Permanent 


User Report List file (utility CTDCA2P). 


• Erase old user/repollt entries from the Active User Repollt List file and erase their 
compressed datasets. Move/copy report; entries from the Active User Report List file to the 
History User Report List file and/or the Migrated User Report; List file (utility CTDDELRP). 


• El'ase report infol1lllation mom the History User Report List file (utility CTDCLHIS). 


• Erase repo:vt information from the Migrated User Report List file (CONTROl:rV utility 
CTVCLMIG). 
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Repository Maintenance 


General 


The CONTROL-D Repository consists of the following files: 


• Aetive Missions file (AMF) 


• Active Transfer file (ATF) 


• User Report List files: 


- 
Aetive User Report List file. 


- 
Permanent User Report List file. 


- 
Histoey User Report List file. 


- 
Migrated User Report List file fo11 CONTROL-V. 


All the files are self-maintained by the New Day p11ocedu11e, or by certain utilities as 
described earlier (e.g., CTDDELRP, CTDCLHIS). 


This maintenance is usually perfo11med on a daily basis. Additional utilities are used to 


perfo11m such maintenance as expanding file sizes, physical' reol'ganization; etc;. An 
explanation, of how to use these utilities follows. 


Eq>anding the Active Missions File 


1. Change CONTROL-D installation parameter AMFSIZE in member CTDPARM to the 
required new Active Missions file size. Assemble the CONTROL-D installation pal'ameters. 
(Alternatively, perform these steps using the Cl'.JSTOMIZE activity in ICE.) 


2: Change parameter AMFSIZE in Gob FORMAMF in, the IOA INSTCTD library) to the new 
size of the Active Missions file. 


3: Run member FORMAMF of the IOA INSTCTD lib11ary. Change the dataset names so you do 
not override the existing Active Missions file and its backup file (e.g., paramete11 TYPE 
should be changed to NEWAMF). 


4. Stop all relatedCONTROL-D activities (e.g~, CONTROL-D monitor, online activities). 


5. Run' utility CTDCCAMF with the following parameters: 


//EXEC C'l'DCAMF, 
II 
OLDAm'='C'l'D.PROD•AMF', 
II 
NEWAMF='C'l'D.PROD•NEWAMF' 
COPY 


II 


old Active Missions file 
new Active Mission file 


Utility CTDCAMF copies the current Active Missions file to the new Active Missions file. 
The utility should end with a condition code of 0. See sample job CTDCAMF in the 


CONTROL-D JCL library for more details. 


6. Rename the old Active Missions file (and its backup file using suffix AMB). 


7. Rename the new Active Missions file (and its backup file using suffix AMB) to the fo11mer 


names of the old file. 


8. Start the CONTROL-D monitol' and resume operation. 
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Expanding the Active Transfer File 


1. Change CONTROL-D installation, pwameter ATFBLK in member CTDPARM to the 
required new Active Transfer file size. Assemble the CONTROL-D Installation parameters. 
(Alternatively, perform these steps using the CUSTOMIZE activity in: ICE.) 


2; Stop all CONTROL-D related activities (e.g., CONTROL-D monitor, online activities). 


3. Rename the old Active Transfer file (and.its backup file - suffix ATB). 


4. Change parameter ATFSIZE in1job FORMATF in the IOA INSTCTD library to the new size 
of the Active Transfer file. 


5. Run member FORMATF of the TOA INSTCTD library. 


6. Run utility CTDCATF withthe following parameters: 


//'EXEC CTDCATF,P=COPY, 


II 
:CNATF='CTD.PROD.OLDATF', 
old Active Transfer file 


II 
OUTATF='CTD.PROD.ATF' 
new Active Transfer file 


II 


Utility CTDCATF copies the cunent Active Transfer file to the new Active Transfer file. The 
utility should be ended:witha return 1code ofO. 


7. Start the CONTROIJJ-D activities and resume operation, 


User Reports List File Housekeeping 


Perform the following housekeeping activities on the User Report List file as required: 


• Reorganize the files 


• Rebuild the Index component 


• Recover a damaged Data component 


Reorganizing the Files 


The Data and Index components of an IOA Access Method file may extend beyond one 
physical dataset. When, an IOA Access Method file extends to, many physical datasets, 
processing may slow down due to the fragmentation overhead. In this case, it is 
recommended to reorganize the IOA Access Method file so that the primary and secondary 
extent datasets are larger. Perform the following steps: 


1. Stop all CONTROL-D related activities (CONTROL-D monitor, online activities, batch 
utilities). 


2. Run the IOADlJL utility to, unload: the contents of the Data component to a sequential file. 


See member CTDUFDUL in the CONTROL-D JCI;, library for an: example. 


3. Increase the value specified' fo11 parameter SPACE in the relevant DEFxxx and DEFxxxI 
definition members to specify larger primary and secondary extent sizes. This pwameter 


should be changed in the definition members 0£ both the Index and Data components. 
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4. Delete all dataset extents ofi the Index and Data components. This step should be performed 
with caution. See member CTDUFDEL in the CONTROL-D JCL library for an example. 


5, Run, the IOADBF utility with pa.11ameter FUNC=INIT to allocate and fomnat the new file's 
components using the new parameters. The utility should be activated twice, once for the 
Data component and a second time for the Index component. See member CTDNFDBF in 
the CONTROl:rD JCL lib11ary for: an example. 


6. Run the IOADLD utility to reload contents of the Data component from the sequential 
dataset previously p11oduced by utility IOADUL, and run: the CTDDIB utility to rebuild the 
Index component. See member CTilNFRST in the CONTROL-D JCL library for an' example. 


7. Resta.11t CONTROl:rD and all' other related activities. 


Dynamic Sorting of the Active User Report List File 


The Active User Report List file can be dynamically so11ted. A detailed' explanation follows. 


The Index component of the IOA Access Method file functions as a balanced tree index. 
The CONTROL-D monito11 can optionally sort the Data component of the Active User 


Report List file so that the physical OI1der of the reco11ds is the same as the logical order of 
the Index component. This automatically p11ovides increased 1/0 performance benefits fol1 


users of the CONTROL-D Online Viewing facility and utilities such as CTDDELRP. 


Dynamic sol1ting of the Active User Report list file does not inhibit the simultaneous 
execution of other CONTROL-D activities, such as decollation1 pl1inting, backup and 
restore mission processing, OI1 access to online user facilities. 


Although dynamic· sorting allows other processes to· be performed concurrently on: the same 
file components, IOA supplies a set of Sort Control parameters that can be specified to 
execute dynamic sort processing at a time of day and at intervals when access to 


CONTROL-D file components is at a minimum. A description of the Sort Control parameters 
can be found in the explanation' of utility IOADBSR in Section 9 of this guide. Dynamic sort 
processing is disabled by default (see parameter ENABLE in the explanation, of the Sort 


Control parameters). 


Dynamic· sort processing of the Active User Report list file is enabled and controlled by the 
parameters specified in member DBSRTPRM in the CONTROL-D PARM library (allocated 
to DD statement DASORTPR in the CONTROL-D monitor's procedure JCL). 


IOA Access Method files can also be so11ted by executing utility IOADBSR as a batch job. 


Utility IOADBSR is described in Section 9 of this guide. 


Rebuilding the Index Component 


To rebuild the Index component, perform the following steps:. 


l. Stop all CONTROl:rD related activities (CONTROL-D monitor, online activities, batch 
utilities). 


2. Run the CTDDIB utility to rebuild the Index component from the Data component. See 


member CTDBFDIB in 1 the CONTR01.-D JCL library fo11 an, example. 


3. Restart CONTROL-D and all other related activities. 
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Recovering a Damaged File 


If dual mirror image file p11ocessing is used, it is possible to immediately recover a 
damaged file. The dual file is an exact copy of the main file. The recovery p11ocedure uses 
utility IOADCPY to copy the entire dual file to the main file or vice versa~ Before starting 
the recovery p11ocedure, make a backup copy of the main file and the Dual file. 


If the Main file is damaged the recovery steps are as follows: 


1. Stop all CONTROl'.rD related activities (CONTRO:D.r-D monito11, online activities, batch 
utilities). 


2. Delete all' extents of the Data component of the main copy only. For example, to delete all 
the extents of the Active User Report List file, list all the files with prefix CTD.ACT.E* and 
delete them. 


3. Run, the IOADCPY utility with pallameter SUFFIX set to the Dual: file (DOOO). See sample 
member CTDUFCPY in the CONTROL-D JCL library for an example. 


4. Rebuild the Index component as described above. 


5. Restart all CONTROL-D activities. 


If the Dual file has been damaged the recovery steps are as follows:. 


l. Stop all CONTROL-D related activities (CONTROl'.rD monitor, online activities, batch 
utilities). 


2: Delete all! extents of the Data component of the Dual copy only. Fol' example, to delete all 
1 


the extents of the CONTROL-D Active User Report List file, list all; the files with p11efix 


CTD.ACT.D* and delete them, 


3, Run the IOADCPY utility with parameter SUFFIX set to the Main file (EOOO). See sample 
member CTDUFCPY in the CONTROL-D JCL library fol' an example. 


4. Rebuild the Index component as described, above .. 


5. Restart all CONTROl:rD activities. 


See Section 9 of this guide for more details about IOA Access Method utilities for User 


Repo11t List files. 


SMF Accounting 


CONTROL-D produces several types of SMF records which p11ovide comp11ehensive 
accounting and chargeback information. 


l. An SMF record fo11 each printed report is p11oduced during deferred. printing. The Record 
number is specified in parameter SMF=nnn in member CTDPARM in the INSTCTD library. 
The record can1 be disabled by setting SMF to NO in member CTDPARM. The structure of 


the record is described in macro CTDSMF in the IOA MAC library. CONTROL-D exit 6 
( CTDX006) receives each record before it is written to· SMF files. The exit can1 change or add 
fields to the record. 
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2. An SMF record can be p11oduced fo11 each printed report during immediate printing; This is 
triggered by optional' wish number WD0892 in member IOADFLTC in the IOA SECUDATA 
libraey. The record number and structure are identical to the ones provided for deferred 
printing. 


3: An SMF record describing activity of an online user is written during logoff operation 
performed under the IOA online monito11. The reco11d contains CPl'.J/EXCP consumed by the 
current user and also the number ofi operations performed by it (e.g;, print, resto:ve, delete 
requests). The reco11d is produced by a specialversiono£IOA exit 6 (IOAX006S). The desired 


reco11d number should be set in the exit. The exit must be recompiled. The structure of the 
record is described by macro CTDSFl in the IOA MAC library. 


4. An SMF record created dulling a decollation process contains the number ofi pages/lines 
processed by a decollation mission; the CPU utilized by it, the number of report entries 
built, etc; The record is built by a special: version of CONTROb-D exit 22 (CTDX022D). 


Desired record numbers should be set in the exit. The exit must be recompiled. The 
structure of the record is described in macro CTDSF2 in, the IOA MAC library. 
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General 


Starting CONTROL-0 


CONTROL-0 is usually started during early stages ofi the IPL process. In this way 


CONTROL-0 can automate the IPL p11ocess (as soon as CONTROL-0 has been initialized). 
To start CONTROL-0 as part ofi the IPL, member COMMNDnn in SYSl.PARMLIB (where 
nn, is either the number specified in member IEASYS in SYSl.PARMLIB, or 00) should 
contain the command:. 


S CON'l'ROLO,SUB=MS'l'R,OU'l'LJ:S'l'=DUMMY[,ORDER=I:PLRULES][,'l'YPE=I:PL] 


Parameters SUB=MSTR and OUTLIST=DUMMY are necessary to start CONTROL-0 


before JES has been brought up. Parameters ORDER and TYPE are optional. For more 
details about these parameters and how/when CONTROL-0 should be started, see 
"Recommended Organization Method~ later in this section, 


If you do not plan to, use CONTROL..-0 to controUhe IPL process, CONTROL-0 can' still be 
started during IPL (after JES has been brought up) by adding the following command to 
member COMMNDnn in the SYSl.P ARMLlB library: 


S CON'l'ROLO 


It is also· possible to manually issue the above mentioned operato11 commands. 


Note 
CMEMusers: 


If CONTROL-M is installed, CONTROL-0 assumes responsibility for the functions of 
the CMEM facility. Therefore it is impontant to verify that the CMEM monitor 
(CTMCMEM) is down before the CONTROL-0 procedure is started. 


For sites with CMEM rules that are to be implemented (triggered) in the early stages of 
the IPL pmcess, command member COMMNDxx in SYSJ.PAR,MLIB should contain 
the following command: 


S CONTROLO, SOB=MSTR, .01J'l'LJ:S'l'=DtJMMY [ , ORDER=J:PLRtJLES] [, CMORDER=J:OAJ:PLCM] [, TYPE=J:PL]. 


For more details about the parameters in the above statement, and how/when 


CONTROL-0 should be started, see "Recommended Organization Method" later in this 
section. 


Shutting Down CONTROL-0 


Although it is possible to use an operato11 command (F CONTROLO,STOP or 


P CONTROLO) to shut down CONTROL-0, it is not recommended. 


It is not usually necessary to shut down CONTROI:.-0. However, if a CONTROI:.-0 shutdown 
becomes necessary, the active CONTROL-0 monitor should be replaced by stallting a new 


CONTROL-0 monitor. See "Replacing an Active CONTROL-0 Monitor" below. 


Use an operator command to shut down CONTROL-0 only if the replacement method does 
not resol¥e the problem .. If operator command F CONTROLO,STOP or P CONTROI:.O is 
used, CONTROb-0 shuts down, after a few seconds. 
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Note 
CMEMusers: 


When CONTROL-0 is shut down, the CMEM facility is also shut down, To restart 


CONTROL-0 CMEM support after CONTROL-0 has been completely·shut down, issue 
the ·following operator command: 


S CON'l'ROLO,TYPE=CTOCMEM 


Replacing an Active CONTROL-0 Monitor 


When a CONTROL-0 monito11 is started (via operator command S CONTROLO) and a 


CONTROL-0 monitor is already active in, the computer, the current CONTROL-0 monito11 


passes execution' control' to the new CONTROL-0 monitor and then shuts down~ It is not 
necessary to reload the rule tables; they are passed from the current monito11 to the new 
one. To, clean (erase) all CONTROL-0 tables from memo11y, shut down the CONTROL-0 


monitor (usually this is done only in an, emergency) .. 


Automatic Loading of Rules 


When CONTROL-0 is started (and it is not replacing an1 active CONTROL-0 monito11), it 
attempts to read a list 0£ rule tables from the member referenced by DD statement 


DARULLST. These are the rule tables to be automatically loaded by CONTROL-0. The 
name 0£ the member can be passed in the CONTROL-0 p11ocedure parameter ORDER. The 
supplied default member RULELIST is in the CONTROL-0 PARM lib11ary. Each line in 
the list has the following fo11mat: 


date 1ib~ary tab1e {FORCE!NOFORCE!ORDER} 


Where: 


date 


library 


table 


Date of the rule .. If a specific date is designated, it is used to analyze the 
Basic Scheduling pal'ameters (see below). The date fo11mat is mmddyy, 
ddmmyy, 011 yymmdd (depending on the site· standavd). 


An: asterisk (*) can be specified to indfoate the current CONTROL-0 


working date .. 


Rule libraey name. 


Rule table name (or mask). 


Fo11 every line in the list, CONTROL-0 loads the specified rule table from the specified 


lib11ary. 


If either NOFORCE or ORDER is specified, each rule's Basic Scheduling parameters are 
compared to the specified date (or the current CONTROL-0 working date when1 * has been 
specified). If the rule should be scheduled on that date, the rule is loaded by CONTROL-0 


and activated. 


If FORCE is specified (the default), each rule is loaded by CONTROL-0 and activated. Use 


this option when you do not wish to use CONTROL-0 scheduling options. 
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CMEMusers: 


When CONTROL-0 is started (and it is not replacing an active CONTROL-0 


monitor), it attempts to read the member referenced by DD statement DACTMLST. 
This member is a PDS member which lists the CMEM rule tables to be automatically 
loaded by CONTROL-0. 


The name of the member containing the list of CMEM rule tables can be passed in 
parameter CMORDER of the CONTROL-0 ·procedure. The default member for the 
CMEM list is member IOACMEML in the IOA PARM library; 


Manual Loading of Rules 


Member RULELIST contains a list of basic rule tables to be activated by CONTROL-0 as 
it is started. To load additional tables, or to replace a currently active table with a new 
(updated) copy o:fthe rules iw the table, use one of the following options: 


Option I 


Enter the CONTROL-0 Online facility and use the ORDER/FORCE option in the Table 
List screen (screen OR). 


Option 2 


Issue·the operator command: 


F CONTROLO, OIF=l.ib:r:>ary(table) [,D=date] 


Where: 


0 
Each rule is ordered. Each rule's Basic· Scheduling parameters are 


compared to· the specified date. If the rule should be scheduled on that 
date, the rule is loaded by CONTROl!..-0 and activated, 


F 
Each rule is forced (loaded by CONTROL-0 and activated). Use this 
option' when you do not wish to. use CONTROI:..-0 scheduling options. 


library 


table 


Rule library name. 


Rule table name (or mask). 


date 
Schedulfug date (optional). If no1 date is specified, the CONTROL-0 


working date is used as the default. Date format is mmddyy, ddmmyy, or 
yymmdd (depending on the site standard). 


Examples 


F CONTROLO,F=CTO.PROD.RULES(CJ:CSPROD) 


Loads table CICSPROD fromi CTO.PROD.RULES. 


F CONTROLO,F=CTO.PROD.RULES(*) 


Loads all tables fromi CTO.PROD.RULES. 


F CONTROLO,F=CTO.PROD.RULES(PROD*) 


Loads tables whose names start with PROD from CTO.PROB.RULES. 
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F CONTROLO,F=C'l'O.PROD•RtJ'LES(?C!CCS~} 


Loads tables whose names start with any character followed by the string "CICS" from1 
CTO.PROD.RULES. 


If the table has already been loaded by CONTROL-0, the new copy of the table replaces all 
the rules 0£ the table active under the CONTROL-0 monitor. 


If you wish to replace all the tables under CONTROL-0 with the list of tables specified in 
DD statement DARULLST ,use the operator command: 


F CONTROLO, OIF=ALL [,REBU!CLD] 


Notes 
When ALL is specified, each table is ordered or forced according to its 
FORCE I NO FORCE specification in the rule list as defined in DD statement 


DARULLST. 


When the REBUILD option is specified, all previously loaded rules are deleted. This 
option should be· specified when using calendar dependent rules. 


If the REBUILD option is not specified, previously loaded rules are either replaced by 
new copies of the rules or lefi unchanged. 


The CMEM table is reloaded automatically when ALL is specified~ 


Manual Loading of CMEM Rules 


The member referenced by DD statement DACTMLST during startup contains a list of 


CMEM rule tables to be automatically Ol'dered by CONTROL-0 when it is started. 


To, load additionaHables, or to replace a currently active table with a new (updated) copy, 
use one 0£ the following options: 


Option 1 


Enter the CMEM Online facility ( =C), and use the· FORCE option in the Table List screen. 


Option 2 


Issue the following operatol' commandc 


F CONTROLO,C=library(table} 


Where: 
c 
Indication that CMEM rules we to be loaded. Each CMEM rule in the 
specified table(s) is 011dered 
1 by CONTROL-0 and: activated~ 


library 


table 


Examples 


Rule library name. 


Rule table name (or mask). 


F CONTROLO, C=C'l'M. CMEM. RULES (DA'l'ASE'l' )• 


Loads table DATASET from CTM.CMEM.RULES. 


F CONTROLO,C=C'l'M.CMEM.RULES(*} 
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Loads all tables from CTM.CMEM.RULES. 


F CONTROLO,C=CTM.CMEM.RULES(BKP*) 


Loads tables whose names start with BKP from: CTM.CMEM.RULES. 


F CONTROLO,C=CTM.CMEM.RULES(?CXCS*) 


Loads tables whose names start with any character followed by the string "CICS" from 


CTM.CMEM.RULES. 


If a specified CMEM table has already been loaded by CONTROL-0, the new copy of the 


CMEM table replaces all the rules of the table active under the CONTROL-0 monitor. 


The following operator command affects CMEM rules as well as CONTROL-0 rules: 


F CONTROLO, 0 I F=ALL [, REBUXLD]. 


This command affects CMEM rules in· the following way: 


• When, ALL is specified, all CMEM rule tables defined in, the CMEM list member (referenced 
by DD DACTMLST) are reloaded. 


• When REBUILD is specified, all' previously loaded CMEM rules are deleted as well as the 


CONTROL-0 rules. 


• If REBUILD is not specified, previously loaded CMEM rule tables are either replaced by 
new copies or left unchanged. 


Deleting (Deactivating) an Active Rule Table 


To deactivate an' active rule table, use an: operator command. For example: 


F CONTROLO, D=C'l'O. PROD. RULES (CXCSPROD)· 


A single rule can also be deleted/held using appropriate line commands ini the Rule· Status 


screen. 


Recommended Organization Method 


CONTROL-O's primary purpose is to automate console operation, An especially important use 
of CONTROL-0 is the automation of system: startup (IPL). Following is the recommended 


CONTROL-0 organization method for automating the IPL process. If you do not wish to 
automate the IPL process, CONTROL-0 organization is simplified since certain, MVS-related 
restrictions do not need to be addressed - in this case you may skip directly to "Rule 
Scheduling" later in this section. 


System Definitions 


• The IOA subsystem name (as defined in IOA Installation parameter SUBSYS) should 


appear as the first subsystem name after the primary subsystem in the subsystem list 
(member IEFSSNxx in SYSl.PARMLIB). This permits CONTROL-0 to control commands 
directed to other MVS subsystems before they are executed by these subsystems. However, 
to control1 JES commands before they are executed by JES, CONTROb-0 uses JES exits or 
an additional subsystem name, defined optionally in the CONTROL-0 installation 
parameters. See parameter JCMDSSN in the IOA Installationi Guide for more information. 
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Note 
MVS 5.2 users: 


The subsystem name can be defined using the method described above aEFSSNnn - 
positional parameter form), or using the keyword parameter form of the IEFSSNnn 
PARMLIB member. 


When using the keyword parameter form, add a record to the IEFSSNnn member in 
the format: 


SUBSYS SUBNAME(xxxx) 


where xxxx is the name of the subsystem as specified in the SSNAME parameter in the 


JOA installation parameters. 


See the MVS I ESA SP 5.2 Initialization and Tuning Reference Manual for further 
details. 


• The CONTROL-0 proceduve must reside in the SYSl.PROCLIB library. 


• The CONTROL-0 monitor should be started at an1 early stage 0£ IPL. To do this, member 


COMMNDnn1 in the SYSl.PARMLIB library (where nn, is either the number specified in' 
member IEASYS in 1the same library, or 00) should contain the following command as one 0£ 


the first commands in the member: 


COM='S CONTROLO,SUB=MSTR,OUTLZST=DUMMY' 


Note 
CMEMusers: 


The COMMNDnn member in SYS1.PARMLIB should contain the following 


command;· 


COM='S CONTROLO,SUB=MSTR10UTLZST=DUMMY[,ORDER=XPIIRULES] 
[,CMORDER=XOAXPLCM] [,TYPE=XPL]' 


The following CONTROL-0 and IOA files are allocated to the CONTROL-0 monitor: 


- 
IOA LOAD library 


- 
IOA Conditions/Resources file and its Synchronization file 


- 
Calendar libl'ary 


- 
PARM library 


- 
Message· Statistics file (dynamically allocated) 


- 
Rules library (dynamically allocated) 


- 
Automation Log file (dynamically allbcated) 


- 
GlobalVaciables lib11ary (dynamically allocated) 


• Because CONTROL-0 is started as part of IPL, you should either catalog alll these files in1 
the MVS Master Catalog, 011 specify the VOLSER and UNIT parameters for each 0£ the files. 
The dynamically allbcated files (e.g~, the Message Statistics file) must be in the Master 
catalog. 


If you specified parameters VOLSER and UNIT fol' these files and you move the files to 
another disk, you must modify the CONTROL-0 proceduve as well~ 


5-6 
JOA Reio 5.0.0Administrator Guide 


I 
. 
\_) 


Section 5: Customizing and Administering CONTROL-0 


• It is recommended that CONTROL-0 start and control' the initialization' of other system 
components (JES,VTAM, TSO, etc;). 


• The on-site enqueue manager must be up befo11e any attempt is made by CONTROL-0 to 
update an1 IOA file. See the description of pa11ameter QNAME in the IOA Installation Guide 
for more information, 


Use of Two Rule List Members 


Parameter ORDER of the CONTROL-0 monitor specifies the name of a member containing 
the list of rules to be loaded by CONTROL-0 upon startup. The easiest organization 
method is using one list member containing all CONTROL-0 tables (e.g., the supplied 
member RULELIST). This is the pI1eferred method when CONTROL-0 will not control 
IPL. However, if CONTROL-0 will control IPL, it should be organized somewhat 
differently. 


As your site's use of CONTROL-0 expands, it is possible that hundreds of operations rules 
will be defined-. Loading all of these operation rules may take time. CONTROL-0 does not 
start to analyze messages until it has finished loading all rules ini the initialization rule 
list. Consequently, if the list is quite large, CONTROI:,-0 may not detect some of the 
messages and commands issued during the beginning 0£ the IPL process. 


To ensure analysis of an messages, it is recommended to place all rules which control the 
IPL process in a separate list. This list is loaded when CONTROL-0 is started by 
overriding the default list member name using parameter ORDER to designate member 


IPLRULES. Member IPLRULES should contain only the rule tables to be used during IPL. 


One of the rules ini this member should load the remaining of the CONTROL-0 rule tables. 


Multiple Rule Table Lists for CMEM Rules 


Parameter CMORDER specifies the name of the member which contains the list o£CMEM 


rule tables (the CMEM list) to be loaded by CONTROL-0 upon startup; It is normally 
recommended to list an your CMEM rule tables in one list (e.g., default member 


IOACMEML). However, as described below, it is sometimes recommended to list certain 
rule tables separately. 


CONTROL-0 does not start to analyze CMEM events until it has finished loading all rule 
tables in the CMEM list specified via parameter CMORDER. If a large number 0£ rules 
have been defined, at your site, CONTROL-0 may not detect some CMEM events during 
the beginning of the IPL process. 


To· ensure detection1 of all CMEM events, it is recommended that you place CMEM rules to 
be triggered during the IPL pI1ocess in a separate list (in member IOAIPLCM), and to 
specify this list via parameter CMORDER. Rule tables specified in this way are loaded and 
activated during the startup process. 
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Replacing the IPL CONTROL-0 


Operation 
1 of CONTROL-0 involves processing phases which are implemented by starting 
separate CONTROL-0 monitors, each one replacing the previous one. 


Phase 1: 


Phase 2: 


Phase 3: 


When CONTROL-0 is activated during·IPI'.. (with SUB=MSTR), certain 
functions are inactive (particularly, the debugging facilities). This is 
because JES is not yet up, and it is impossible to allbcate a sysout file. For 
this reason~ CONTROl!.-0 is started with, parameter OlJTLIST=DlJMMY. 


A simple CONTROI;,-0 rule can detect the JES initialization message and 
then restart CONTROL-0 (this time without parameters). A sample rule 


can: be found in the table STARTSYS. The new CONTROl!.-0 


automatically takes control: from the previous CONTROL-0 used during 


IPL. You do not need·to,reload the rules. 


During shutdown of the system, if CONTROl!.-0 controls the termination, 


of JES, a third CONTROl:rO monitor is required which does not allocate 
sysout files. This CONTROL-0 monitor should be started (by a rule) with 


SUB=MSTR and, OUTLIST=DUMMY. 


Parameter TYPE of operator command START CONTROLO enables you to specify the 


CONTROIJ-0 processing phase for a specific monitor. Valid, values for this parameter are: 


IPL 


REGULAR 


SHUTDOWN 


The CONTROL-0 monitor controls the IPL process. 


The CONTROL-0 monitor is a regular CONTROL-0 monitor. 


The CONTROL-0 monitor controls the shutdown of the system, 


The CONTROL-0 TYPE appears in the following initialization message: 


C'l'0147J: 
CONTROL-0 :CN:C'l'J:AL:CZA'l':CON COMPI:.E'l'E,'l'YPE=type,SUB=jGb-ent:r:y-subsystem 


This message can be used by CONTROL-0 rules whenever phase-dependent pllocesses are 
handled. 


Note 
When CONTROL-0 is brought up to replace an existing CONTROL-0 monitor, it does 
not load rules from DD statement DARULLST. Instead, it takes control of the rules 
which were active under the previous CONTROL-0 monitor. Only· a new operator 
command F CONTROLO,O=ALL loads the rules from DARULLST. 


CMEMUsers: 


The above note is also. true for CMEM rules to be loaded from DD statement 
DACTMLST. 


Rule Scheduling 


CONTROL-0 is usually sta!'ted at an1 eal'ly stage of IPL and remains active until 
shutdown .. Most rules behave the same on, any business date .. However, it is sometimes 
necessary to schedule different rules fov different business dates. For example, you may 
want to. trigger a response to. a certain message on1 a regular business date and a different 
response to the same message on the first day of a month. 
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Under CONTROL-0 you can define scheduling parameters for rules .. For example, a rule 
can be scheduled for a specific date only. The scheduling criteria of rules are checked when 
a rule is ordered (either automatically or manually). Therefore, if a certain rule is 
sensitive to scheduling criteria, its table is loaded (ordered) oni a daily basis. The rule 
scheduling criteria are then checked on a daily basis - the rules are loaded and activated 
only if they should, be scheduled according to the scheduling criteria. 


The recommended method to reload the rules on a daily basis is using a time-initiated 
command (a rule) which issues an order command for aU CONTROL-0 tables at a specified, 
time of the day: 


F CONTROLO,O=ALL,REBU[LD 


Displaying Active Rules 


The Rule Status screen1 displays a list 0£ all rules which have been' ordered and their 
statuses. The displayed rules can be held/deleted/freed. Alternatively, entel' operator 
command F CONTROL.O,DISPLAY. The list is sent to the console; 


Controlling the Message Statistics Facility 


The Message Statistics facility allows accumulation and display of statistics for the 
messages/commands issued by the system on which CONTROL-0 is active. 


The Message Statistics facility counts messages and commands by message/command ID. 
Each time a message or command appears, the counters for the corresponding entry in' the 


Statistics file are incremented. When a new message ID or %%STATID value is detected, a 
new entry is opened in the Statistics file. 


Statistics accumulation is normally started automatically when CONTROL-0 is br:ought 
up; However, when necessary, accumulation of statistics can be controlled by the following 
operator commands: 


l. Stop statistics accumulation: 


F CONTROLO,STOPSTAT 


This command can' be used if statistical: accumulation is no longer required or if it becomes 


necessacy to reformat the Statistics file without br:inging down CONTROL-0. 


2. Start statistics accumulatiom 


F CONTROLO,STARTSTAT 


3~ Reset statistics for: all messages and commands: 


F CONTROLO,RESETSTAT 


Preventing Unnecessary Enlargement of Statistics Files 


The Message Statistics facility counts messages and commands by message/command ID. 
The first word 0£ the· message/command is the message/command ID. 
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To prevent the Statistics files from becoming too large and from containing duplicate 


infol'mation~ it might be desirable to group messages or commands according to other 


criteria. It would be useful, for example, to group messages/commands under one 
message/command ID when: 


• Messages start with free text, and each new message is normally accumulated under a new 
message ID, thus unnecessarily enlarging the size of the Statistics file .. 


• Concatenation of JES2 commands with different operands normally results in, separate 
statistics accumulation' for each operand. For example, statistics for $PJ05555 and 


$PJ01234 are normally accumulated under different IDs, even though both IDs refer to the 
same command, 


• Accumulating separate statistics for messages which are not of interest to the user can be 


wasteful' 


AutoEdit reserved variable %%$STATID can' be used to specify the ID under which the 
messages/commands ave accumulated, For example:. 


ON COMMAND $P* 


DO SET %%$STATZD=$P 


Rule table STATS from the RULES library has been, provided to perform the necessary 
grouping by %%$STATID. This table can be adapted/used according to site requirements. 


Handling Near-Full and Full Conditions for the Statistics File 


When the Statistics file becomes move than 90% full, CONTROL-0 issues unrollable 
message CT0240W as a warning. 


When: CONTROL-0 detects that the Statistics file has become full; it issues unrollable 
message CT0241E .. CONTROI:.-0 theni stops tracking statistics for new messages but 
continues to update the counters of messages already listed in the Statistics file. 


If message CT0240W and/ov CT0241E is issued, it is recommended: that the operator 
enlarge the Statistics file (via utility CTOCSF) and check if messages can be grouped by 


%%$STATID (described above). 


Controlling the Automation Log Facility 


The Automation Log facility allt1ws accumulation and display of automation, information 


from all inputs available to CONTROL-0. 


The Automation' Log facility is started automatically when parameter AUTOMLOG in 
member CTOPARM is set to V or D. (Refer to the CONTROL-0 section in the IOA 
Installation Guide.) 


While CONTROL-0 is active, the Automation, Log facility is controlled by the following 
operator commands: 


1. Stop Automation Log accumulation: 


F CONTROLO,AUTOLOG=NO 
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This command can be used when the Automation Log is no longer required or when it 
becomes necessary to reformat or rebuild the Automation Log file without bringing down 


CONTROl!r-0. Message CT02971 indicates that Automation Log accumulation has stopped. 


The Automation Log can be viewed via screen OL, even when CONTROL-0 is inactive or 
Automation Log accumulation has been stopped, 


2. StaJ.lt Automation Log accumulation: 


F CONTROLO,AUTOLOG=YES 


Message CT0297l indicates that Automation' Log accumulation has started. 


Note 
When the Automation Log is not active, CONTROL-0 trace messages are written to 
the SYS OUT specified by DD statement DAACTLOG of the CONTROb-0 monitor. 


Determining the Size of the Log 


The Automation Log is a wrap-around dataset, which means that the number of records in 
the file is constant and\ when the file is full, a new reco11d overwrites the oldest reco11d. Old 


Automation Log entries may be archived/backed up for subsequent retrieval using utility 


CTOALOCP (described in Section 9 of this guide). 


If backup is performed on1 a regular basis, the size of the Automation Log should be such 
that no record 
1 is overwritten· before backup has taken place. The appropriate size for an 


Automation• Log is specified in installation parameter ALREC#. The backup frequency 
depends on site requi11ements. 


Preventing Logging of Unnecessary Messages 


Some messages may be of little interest. These messages should not be written to the 
Automation Log, so that the amount of unnecessary information1 on the Automation Log is 
minimized. 


Systemi AutoEdit variable %%$AUTOLOG can 1 be used to control1 which, messages are 
entered into the Automation Log. Valid 
1values are: 


Y (Yes) 


N (No) 


Example 


ON MESSAGE 'l'S'l'* 


Record the message in the Automation Log, 


Do not reco11d the message in the Automation Log. 


DO SET %%$AUTOLOG=N 


Prevents messages whose ID starts with TST fromi being written to the Automation Log. 
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Controlling Rule Operation Mode 


The mode of operation, (i.e., the trace mode) for a rule is determined by parameter MOBE 
in1 its rule definition, Sometimes it is useful to override the operation mode of all active 
rules and 
1 verify that events and actions are reco11ded in a particular way. For example: 


• EnsU11e a fun trace of all! rules (i.e., all events and actions we reco11ded) to facilitate analysis 
of the interaction between1 rules. 


• Record (trace) only the triggering of every rule. 


Global trace operations are requested via operator commands, as follows: 


1. Activate a fullitrace: 


F CON'l'ROLO,LOG=ALL 


All rules are fully traced as if they were defined, with mode LOG. This operator command 
should only be used temporarily for specific tests because extended use of full' trace mode 
can' adversely affect CONTROL-0 performance. 


2: Trace rule triggering only: 


F CONTROLO,LOG='l'R:CGGER 


Only rule triggering is traced' foll all rules. However, rules defined with mode LOG we fully 
recorded. 


3. Restore the default operation, mode (as defined in the rule definition~ for each rule: 


F 
CONTROLO,LOG=DEFAUL~ 


Global AutoEdit Variables 


When' CONTROL-0 is started, it reads the members of the Global AutoEdit libl'ary and 
loads into memol'y the Global variables that reside in those members. The list of members 
loaded is specified in the DD DAGLBLST statement of the CONTROL-0 monitor. A 
different Global libllary (in' which the Global members reside) is used fo11 each computer 


(SMF ID) on which CONTROb-0 operates .. The Global libl'ary name is composed of the 
prefix defined in1 the GLBPREF parameter 0£ the CONTROL-0 installation, parameters, 
the Global identifier: .GLB., then the string CP'C:J followed by the SMF ID of the specified; 


computer. Example: CTO.Vxxx.GLB.CPUSYSA. 


Member $GLOBAL is usually the default Global member and it contains the CONTROL-0 


Global AutoEdit variables that are not assigned to specific Global members. The member 
format is identical to that of a CONTROL-M AutoEdit variables member format. Therefore 


CONTROb-0 Global members can be refeDenced; by CONTROL-M jobs via the MEMSYM 


and LlBSYM parameters. 


Any updates 011 additions to Global variables (by rules or KOA scripts) are kept in memory 
by CONTROL-0 and are available to all other rules .. While CONTROL-0 is active, Global 
variables can be reloaded from the PDS (partitioned dataset) Global 
1 library or written 
back to the PDS Global library, in totality 011 by member name, using the LOADGLOBAL 


and WRITEGLOBAL operator commands. When, CONTROL-0 is stopped, the Global 
variables are written back to their respective PDS members. 
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To update the Global members with the current status of the Global variables, use the 
following operatol' command: 


F CON'l'ROLO, WR:I'l'EGLOBAL [ { =memname I =ALL}] 


When1ALL is specified, all members listed in the DD DAGLBLST statement are updated. 


When memname is specified, only the specified member is updated, and only on the 
condition that its name appear in the DD DAGLBLST statement. 


When no specification follows the WRITEGLOBAL parametel', only the default $GLOBAL 
member is updated~ 


To load Global members from memory, use the following operator command: 


F CON'l'ROLO, LOADGLOBAL [ { =memname I =ALL}] 


When ALL is specified, all members listed in the DD DAGLBLST statement are loaded, 


When memname is specified, only the specified member is loaded) on the condition that its 
name appear in the DB DAGLBLST statement. 


When' no 1 specification follows the LOADGLOBAL parameter, only the default $GLOBAL 
member is loaded. 


Defining a New Global Member 


Rules related to a specific application can use their own Global member to isolate their 
variables fromi the rules of other applications, and enable the use of checkpoints or to 


perform initializations on an application' basis. 


To define a new Global member, it is necessa11y to create a member in the GLB lib11ary, and 
to: add its name to the Global Member list. This list is defined by the DD DAGLBLST 
statement of the CONTROL-0 monitor, and it usually resides in the DAGLBLST member 
of the CONTROI:,-0 PARM library. 


Each line describes a Global memben. Valid format is: 


member attribute 


Where: 


member 


attribute 


Global member name. 


Type of Global 
1member. Values a11e: 


IN OUT 


INPl:JT 


Load and update of the member a11e performed using 
commands LOADGLOBAL 
and WRITEGLOBAL as 
described above. 


The member can be loaded but never written back. This 
option, may be used for storing Global: AutoEdit variables 
whose initial values are specified in the member and do 
not requwe checkpointing. The value of each Global 
AutoEdit variable may be changed and new Glt>bal 


AutoEdit variables can: be added to the member during the 


CONTROL-0 session, but these new values and new 
variables a11e not saved when CONTROL-0 is stopped. 
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PROTECTED Global AutoEdit variables which reside on a PROTECTED 


member cannot be updated during the· CONTROL-0 


session1 and, no· new Global AutoEdit variables can be 


assigned 
1 to' the member. This option can be used for 
storing Global, AutoEdit variables that are "constants" 
(i.e., the messages of an application). 


TEJMPORARY The Global1 member associated with this entry does not 
reside on 
1 the disk; therefo11e, it is not loaded and it is not 
written, back. This option1 is useful, for Global AutoEdit 
variables that do 1not need to be saved, after CONTROL-0 


is stopped. 


Once the new Global member has been defined and listed as described above, it is 
necessary to· activate it with the following operato11 command: 


F CONTROLO, 
LOADGLOBAL=membe~ 


Where: 


member 
Global member name. 


Automatic Compression of the Global AutoEdit Library 


Because o:f its PDS (Partitioned dataset) organization, the Global, AutoEdit library is p11one 


to D37 ABENDs (due to insufficient space to write on disk either a new member or an1 
updated version o:f an, existing member). If, at your site, there is no product to keep the 
library comp11essed1 CONTROL-0 enables you to automatically comp11ess the Global 
Auto Edit variables lib11ary, whenever it becomes full; as explained below. 


The Automatic Compression facility is no11mally activated when the Global AutoEdit 


lib11ary is full (i.e., when a D37 abend' is encounte11ed during a WRITEGLOBAL operation). 


Befo11e attempting to comp11ess the Global:AutoEdit library, CONTROL-0 backs the lib11ary 


up to a sequential file via utility IEBCOPY. 


The Automatic Compression, facility uses member $$COMPST of the Global AutoEdit 
library to track the p11ogress of the compression ope11ation, $$COMPST is a single record 
member that is created automatically when the Global lib11ary is defined'. 


Fo11 each step. in the backup/compression, process variable %%STATUS in membe11 
$$COMPST is updated, to reflect the status of the comp11ession 1 process. Possible values fo11 


this variable are: 


%%STATUS=Sl 


%%STATUS=S2 


%%STATUS=OK 


Backup o:f the Glbbal1 AutoEdit library has been started but not 


completed. 


Backup· of the library was successful. Compression has been started but 
not completed (i.e., is either still in process or it has failed). 


Compression has been1 successfully completed; 


Whenever the Global AutoEdit library is accessed (via a 
LOADGLOBAL or 
WRITEGLOBAL operation), the value o:f %%STATUS is checked to ensure that the lib11ary 


was not corrupted1 during the last automatic compress operation, 
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• If the value of %%STATUS is OK, the requested LOADGLOBAL or WRITEGLOBAL 


operation is performed~ 


• If the value of %%STATUS is S2, the Automatic Compression facility automatically restores 
the Global AutoEdit lib11ary mom the backup file and compresses it before execution of the 


LOADGLOBAL or WRITEGLOBAL operation~. 


• If the value ofi %%STATUS is 81, the Global AutoEdit library and backup may be corrupt 


and the operation cannot be perfo11med. An erro11 message is issued. 


Enabling Automatic Compression 


If automatic comp11ession ofi the AutoEdit variables library has not been enabled at time of 
installation, it can be enabled by performing the following steps: 


L Brong down CONTROL-0. 


2. Specify Y fol" pailameter GLBCOMP in member CTOPARM of the IOA INSTCTO library, 


and submit job .CTOP ARMJ. 


3: Submit job NEWGLOB in the IOA INSTCTO library .. This job does the following: 


• Renames the old Global AutoEdit library. 


• Defines a new Global AutoEdit library (using the old library name) and a sequential 
backup file (used by the Automatic Compression, facility). 


• Copies the contents of the renamed Global AutoEdit lib11ary to. the new Global AutoEdit 


libracy. 


4. Restart CONTROL-0. 


Modifying the CONTROL-0 Sleeping Interval 


CONTROL-0 wakes up every few seconds and checks on time-related events. This time 
interval is defined in the CONTROL-0 installation parameters and can be changed by the 


system administrator. In addition, the interval can be modified by the operato11 command: 


F CONTROLO,IN'l'ERVAL=XX 


Where XX rep11esents the interval in, seconds. 


If CONTROL-M is active at your site, it is recommended that you specify an interval 
sho11ter than, the CONTROL-M intervali. 


It is recommended that the interval be. modified by' automatic commands which will be 
invoked by the CONTROL-0 monitoI' itself, according to set conditions and time ranges 
and not manually by the operator. 


The optimal, sleeping interval depends on the processing power of the machine. Depending 
on the processing power ofi the machine indicated below, the sleeping interval 
1 should 
usually not be less than the number of seconds indicated: 


• For machines with less than 20 MIPS 
10 seconds 


• For machines with 20-50 MIPS 
5-6 seconds 


• For machines with over 50 MIPS 
4 seconds 
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There is no· practical benefit in setting the interval to less than the above minimum. 
Moreover, it could actually slow down: CONTROL-O's operation. 


When the modification is accepted by CONTROL-0, the following message appears on the 
operator console:. 


Co:r<>123I CONTROL-0 INTERVAL IS SET TO ## SECONDS 


Refreshing the CONTROL-0 Security Cache 


CONTROL-0 security modules use a security block to identify each user fo:r: which an 
authority check is perfo:r:med. The first time a user's security authorization is checked 


CONTROL-0 creates a security block fo:r: that user. The security block can then, optionally 
be saved 
1 fo:r: the next time the user's security autho:r:izationiis checked .. 


Security blocks saved for subsequent checks are kept in1 the CONTROI:,-0 Security Cache. 


The size o£the security cache is defined in parameter RUNTCACH in member CTOPARM. 


If 0 is specified for parameter RUNTCACH, no· security blocks are saved .. (See "Perfo:r:ming 


Post-Installation Tasks" in the IOA Installation1 Guide fo:r: information about how to alter 
the specification for this parameter.) 


The CONTROL-0 Security Cache holds security blocks for only the last x users to have 
their security authorization checked (where x is the value specified for pal'!ameter 
RUNTCACH). For example, if parameter RUNTCACH contains a value of 10; the security 
cache holds a security block for each of the last ten, users that were checked. 


Changes made to a user's security autho:r:ization: (since the last time that user's security 
block was created) are not automatically included in the information in the user's security 


block in the CONTROL-0 Security Cache. However if a user's security authorization has 
been changed) and there is no security block in the CONTROL-0 Security Cache fo:r: that 
user, changes made to the user's security autho:r:ization are put into effect the next time 
that user's security autho:r:ization is checked, 


To immediately include new user authorization information' in the CONTROL-0 security 
cache, refresh the security cache via the following operator command: 


F CONTROLO,NEWSECDEF 


This commandremeshes all user authorization information in the CONTROb-0 security cache. 


When the modification is accepted) the following message appears on the operator console:. 


CT0251I RUNTIME SECURITY REFRESH ENDED OK 


Problem Determination 


CONTROL-0 is supplied: with internal debugging facilities: The ability to print an, internal 
debugging trace and the ability to print the contents 0£ the CONTROL-0 internal data 
areas .. Under no:r:mal circumstances, the debugging facilities are do:r:mant. However, i£ 


required' (i.e., your; IOA rep:r:esentative has requested debugging information), it is possible 
to activate the debugging facilities as follows:. 


Activate the CONTROL-0 internal trace: 


1. Performieither step A or B. 
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A. Start a new CONTROI:.-0 monitor with the following operator command: 
s CONTROLO,DEBUG=level 


The CONTROL-0 monitor passes control:to the new CONTROL..-0 monitor and shuts down. 


Oil 


B. Issue the following operator command: 


F CONTROLO,DEBUG=level 


The required debugging level will be supplied by youl' IOA repl'lesentative .. It can, be any 
value fimmi 00 to 255 (00 specifies no debugging whatsoever). 


Note 
It is highly recommended that you not activate CONTROL-0 with the DEBUG 
parameter on a regular basis because in case of a JES problem,. CONTROL-0 


may·become suspended while waiting for JES. 


2. The debugging information will be printed to DD statements PRTDBG and DAD'l:JMP 0£ the 


CONTROL..-0 p11ocedul'e. 


3:. When' you have finished your pl'loblemi determination p11ocedures, start a new CONTROL-0 


using the following operator command: 


S CONTROLO 


Ol'I specify the operator command: 


F CONTROLO,DEBUG=OO· 


Print CONTROL-0 Internal Data Areas 


To print CONTROL-0 internal data areas, issue the following operato11 command: 


F CONTROLO,SNAP[=na.me1,name2 ••••• ,na.men] 


Where:. 


namel, name2, .... namen are the names of the CONTROL-0 internal data areas. 


When' no name is specified, all data areas are pri.nted. Your IOA representative will 


pl'lovide you with the list 0£ the data area names and will specify which areas should be 
printed depending on the problem encountered. 


Valid values are: 


ALL 
LINK 
MTOPI:.B 
OMT 
RQCDLY 
RQCSTO 
SSVT 


ALO 
MAIN 
MTOPND 
OPR 
RQCEXO 
RQH 
STO 


CAS 
MCT 
MTOPNX 
PARM 
RQCFREE 
RULES 
SWT 


CONLIST 
MTO 
MTOSRV 
PND 
RQCMTO 
SEC 
UCM 


CONS 
MTOINX 
MTOSRVA RFR 
RQCRFR 
SLO 
VARS 


CONSOLE 
MTOLNK 
MTOWSC 
RQC 
RQCSLO 
SRV 
WISHES 


DLY 
MTOMIX 
MVS 
RQCALO 
RQCSRV 
SSCT 
wsc 


EXO 
MTOMPT 
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When the snap is completed, the following message appears on the console: 


CTOlSOI SNAP COMMAND WAS PERFORMED SNAPID=xxxx 


Where:. 


SNAPID is the snap identifying number which appears on the lower right of the screen 


after the snap is completed. 


Displaying Internal Resource Utilization 


To obtain information' on internal resource utilization, issue the following operator 
command: 


F CON'l'ROLO,WATERMARXS 


The response to this command is displayed as message CT015DI. See the IOA Messages 
and Codes manual fo11 an explanation of: this message. 


Customization of Automation Options 


Automation, Options (AOP) screens can' be modified· and new screens defined to, meet site 
requirements. (Refer to 1sections 1and2 in the CONTROL-0 User Manual fol" a description 
of the Automation Options facility.) 


AOP Overview 


The Automation Options facility is comp11ised 0£ the following components:· 


1. Menu Definition, Members 


Each menu definition is written in a member containing parameters (keywords and values) 
that describe the options in the menu1 The following are defined for each optionc 


• Name 0£ the option1 


• Parameters that define the format of the display line. 


• Name of the program to be executed, 011 (for a submenu) name of the member containing 
the submenu definition. 


Menu definition, members for each Automation Option should' be assigned the same name as 
the menu, p11efixed by##, in the IOA MSG lib11ary. Fo11 example, the definition for menu 


OPER should reside in 
1member ##OFER. 


The main Automation Options menu is defined in, member ##AOP. 


To update or add an' Automation Option, it is necessary to access the appropriate menu 
definition' member and modify it as described' later in this section. 


2:. Format Members 


Formats describe how lines provided by a client program are to· be displayed on the screen~ 


The format of the primary Automation: Options screen provided: by CONTROL-0 is specified 
in member $$AOP in the IOA MSG library. The user can write new formats and: save them 
as members in the IOA MSG library. 
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Note 
Member $$AOP should not be modified to avoid problems in the execution of the 
feature. 


3: Client programs 


Client programs can be any independent load module, TSO CLIST, or REXX EXEC, which 
the Automation Options facility invokes either to· perform functions or to provide lines to be 


displayed~ 


Menus 


Update the app11op11iate member (in the IOA MSG libra11y) with the parameters of the new 
options .. Each of the parameters (described below) defines a line in the specification of the 
new Automation Option• 


Menu Member Syntax 


The following syntax rules should be considered' when defining menus of new options. 


• A menu statement consists of one or more lines, each with of a maximum of 72 columns .. 


• Each menu statement is comprised of a parameter (keyword) and its value, separated by one 
or several blank spaces. Parameters can be specified in uppe11case or lowercase. 


• Data can be specified anywhere between columns 1 and 71. 


• A non-blank character in column 72 indicates that the statement is continued on' the next 
line. 


• Data on continuation lines must start at column 16. 


• An asterisk (*) in column, 1 specifies that the line is a comment. 


Parameters 


OPTION 


DESC 


LINECMD 


Name of the option (1-8 characters) as it appears in the menu screen. 


OPTION must be unique within the menu member. Mandatory. 


Parameter OPTION heads a group of statements .. The group ends when a 
new OPTION parameter or the end of file is encountered~ 


Example: OPTION USERINFO 


Description, 0:£ the option as it appears in1 the menu screen. DESC is a 
string of 1-70 characters, enclosed in.single quotes. Mandatory. 


Example: DESC 'Query USER database' 


Line command character. This character defines the line command used 
to select the option· to· be executed from the Automation Options entry 
panel. 
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PROGRAM 
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The line command chwacter can be any character, with the exceptioni of ? · 


which, does not invoke the client program, When selected, ? displays the 
prompt window. 


LINECMD heads a subgroup of statements that define actions to be 


perfoJ.1ID.ed when' the specified line command is specified. The subgroup 
ends when, a new LINECMD, a new OPTION, or end of file is 


encountered, 


At least one LINECMD must be specified within an OPTION group of 
statements.. The following parameters help define the LINECMD 


subgroup:. PROGRAM, 
PROMPT, 
PARM, 
RETURNS, 
FORMAT, 


OPTI'...IST. They are described below. 


Program name (1 to 1 8 characters). Mandatory within1 a subgroup of 


statements headed: by a LINECMD statement. PROGRAM. names a client 


program' which is invoked when: the preceding line command LINECMD 


is entered. The p11ogram can be any regular load module, a TSO CLIST, or 


a REXX. EXEC. The PROGRAM statement can include subparameters to 
define special: program, attributes. When no1 subparameters we specified, 
the client program: performs according to 1 Automation Options standard 
linkage conventions (described 1 in· member DOCOAOCP in the IOA 
SECUDATA lib11ary) and is called an1AOP program, 


Optional subparameters are: 


IMMEDIATE Prompt window is not displayed~ If parameters are 


specified~ they are passed directly toithe program. 


NOSCREEN 
Display lines we not returned, (The client program may 


perform 1 its own 1 terminal 
1 I/O, without using the 
Automation 
Options 
facility.) 
Programs 
specifying 
NOSCREEN can' be invoked. only under TSO. 


ISPFENV 
Valid ISFF environment is required. Programs specifying 
ISFFENV can be invoked only under ISFF. 


TSOCF 
Client program is invoked as a TSO command processor. 


EXECPGM 
Parameters are passed to the p11ogram in· the format o:f: the 


PARM= statement ofaJCI:, EXEC p11ogram, 


REFRKEY 
Definitioni of function, key(s) for REFRESH action. Valid 


values we ENTER and PF4 .. Default value is PF4. 


Examples 


PROGRAM AOPGUINF 


Client program retrieves user information which is displayed later on the 
screen. 


PROGRAM SDSF IMMEDIA'l'E NOSCREEN TSOCP 


TSO command processor does not receive any prompts and performs its 
own: terminal I/0. 


PROGRAM CLIST1 IMMEDIATE NOSCREEN TSOCP · 
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TSO CLIST does not receive any prompts and performs its owni terminal 


1/0. 


PROGRAM CTO'l'AMN 


OP'l'L~S'l' ## SAMPLE 


Invoke supplied program CTOTAMN to, display the submenu defined in 
member ##SAMPLE .. 


Request for data to· be passed to· the client program. Optional, A 


maximum 0£ 14 PROMPT statements may be 
specified~ When the 


LINECMD character is specified and at least one PROMPT parameter 
has been specified, a prompt window is opened with as many prompt lines 
as PROMPT parameters in, the menu. The user fills in the required input, 
then presses <ENTER>, thus calling the client program •. The answers to 
the prompts are passed to the client program, as an array unless 
parameter PARM (described below) is specified~ Valid, format is: 


PROMP'l' data1,length,data2 


Where: 


datal 


Length 


String 0£ 1-20 characters between quotes. It is considered 
a comment and should be used to describe the required 
input. Mandatory. 


Decimal number (0-44) specifying the length of the prompt 
input field~ Mandatory. 


String in quotes specifying the prompt's initial value. Optional. If data2 is 
specified, its length must be less than 011 equal1 to· length. Default value is 
blanks. 


Examples 


PROMP'l' •user name ====>>',8 


The user is prompted to enter an 8-byte input field. The field is initialized 
to blanks. 


PROMP'l' 'Department ====>> • ,20•, ''l'ECH-SUPPOR'l'' 


The user is prompted to enter a 20-byte input field~ The field is initialized 
to the value of 'TECH-StJPPORT' padded to the right with blanks. 


String delimited by two identical chwacters (e.g., both PARM /xxxf and 
PARM 'xxx' are valid; PARM /xxx' is invalid since the delimiters of the 
string are not identical). 


The string contains input parameter(s) that is required by the client 
program. Data between the delimiters can consist 0£ any characters 
(except the character chosen• as delimiter), including special AutoEdit 
variables: %%Pn and %%., where: 


• %%Pn is the value assigned to PROMPT number n. 


• %%. is a special· variable used to concatenate twoAutoEdit variables. 


Functions such as %%$SUBSTR can also be specified~ 
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After AutoEdit symbols have been, resolved) the string's length cannot 
exceed 255 characters. 


Example 1 


PARM #00' '77# 


Passes to the client program1the value: 00~ '77 


Example2 


PROMPT 'User name====>>', 8 


PROMPT 'Department ====• ,20:, 'TECH .... SUPPORT' 


PARM /Ql1ERY,USERID=%%P1,DEPARTMENT=%%P2/ 


The first parameter is blank and the second parameter is TECN- 
SUPPORT. 


If the user enters UserA on the first PROMPT line, leaves the second 


PROMPT line unchanged, and presses <ENTER>, the following string is 
passed! to the programc 


QUERY,USERID=UserA,DEPARTMENT=TECH-SUPPORT 


Note 
When both PROMPT and PARM statements are specified, the 
order of their appearance within the menu is not important; 
however, the data is passed to the program as specified in the 
PARM statement. 


String, delimited: by quotes (maximum 200: characters), which defines the 
layout of: a line of display. Optional. Default is: 1 LINE +77. If display 
type A exists in the format member of the option, it must contain the 
name of all the variables defined here. 


The string is a simple CONTROl!..-0 template which names the format 


variables and them positions in the· displayed line; Variable names must 
not exceed eight characters and their positions must be specified 
numerically only. (Refer to. the description, of the %%$PARSE function in 


Section 
1 4 of the CONTROI!..-0 User Manual for detailed information on: 
templates.) 


For each variable on, the template, the following fields should be specified: 


starting position Starting position' of the variable on1 the template string 


variable name 


length 


Example 


(character). 


Name of: the variable (in uppercase). 


Length of the variable (character). 


RETURNS 'l FXRS'l'NME +8 20 LASTNME +12 60,ADDRESS +35' 


Divides the returned lines into the following displayable variables:· 


FIRSTNME 


LASTNME 


ADBRESS 


Begins in column 1 and its length is 8 characters. 


Begins in column 20 and its length is 12 characters. 


Begins in1 column 60 and its length is 35 characters. 
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These variables must be defined in the corresponding format member. 


Note 
RETURNS cannot be specified for programs speci/Ying 
NOSCREEN. 


Name of the format member ( 1-8 characters) used for displaying the lines 
returned from the client program. Format member name must begin with 
$$, in accordance with Automation Options conventions. Optional. 
FORMAT is ignoved if specified in a menu together with subparameters 


NOSCREEN, TSOCP, or EXECPGM. 


Example 


FORMA'l' $$U:CNFO 


$$UINFO is the format member for use in displaying the return lines. 


Name of a lower level menu member (1-8 characters). Optional• To 
process a lower level menu, invoke the supplied. program CTOTAMN and 
specify the $$AOP format member (or a similar format member) to 
display your customized Automation Options screen~ OPTLIST must 
begin with ##, in accordance with Automation' Options conventions. 


DESC 'Query USER database• 


L:CNECMD · S · 


PROGRAM C'l'O'l'AMN 


OP'l'L:CS'l' ##U:CNFO FORMA'l' $$AOP 


RE'l'URNS '1 OP'l':CON +8 9 DESC +60' 


When Option USERINFO is selected (by specifying S ini the select option field of the 


Automation Options screen), a new screen, is displayed, showing the user-defined 
Automation Options specified in the ##UlNFO menu member. 


Format Members 


Format members are used to format the lines displayed on the screen.. Refer to· the 


"Customizing IOA Display Fol'mat Members" in Section 2 of this guide fol' details on how 
to· define and customize format members. 


Note 
The first @FIELD in each @LINE must be SAOPLCMD. The other @FIELDs in each 
@LINE must contain variables that match those in the RETURNS statement of the 
menu. 


Client Programs 


A client program is a load' module, a TSO CLIST, or a REXX EXEC that is invoked by the 
Automation Options facility when selected by a line command, chal'acter (other than ?). 
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Programs may be called that do 011 do not require parameters to perform' a certain function 


and 
1 then return, without displaying lines. Sophisticated AOP p11ograms receive pa11ameters 
via PROMPTs 011 PARM statements and return lines fo11 display. 


The program attributes ini the menu define the p11ogram characteristics. Before the 


p11ogram is called, the Automation, Options facility reviews those attributes and takes 
special actions if necessary. 


Examples 


If ISPFENV is specified, the Automation Options facility ensures that a valid ISPF 


environment exists befo11e invoking the client program~ 


If IMMEDIATE is specified, the Automation Options facility checks the PROMPTs and the 


PARM specification in' the menu, if any-, and passes the data to the client p11ogram without 
displaying it on the screen. 


General registers 1 - 15 contain the following information at time of entry to the client 


p11ogramc 


R15 


R14 


R13 


Rl 


RO 


R2.:.R12 


Entry point of the called program 


Return1 addlless 


Addlless of save avea 


Address of input data 


NIA 


NIA 


Program Input 


The p11ogram input vallies according to the type of the programc EXECPGM, TSOCP, 011 
AOP (client program as described' above). A full description, of the input data is included in 
member DOCOAOCP in the SECUDATA lib11ary. 


Execution Process 


Client p11ograms of the TSOCP or EXECPGM type must follow the rules specified below: 


1. The p11ogram is to be considered an extension' of IOA. Since it runs under IOA, an abend of 
the client program' triggers an abend of the IOA session, Storage overlays within the 
program may produce unpredictable results. 


2. Registers must be saved and restored acco11ding to standavd IBM conventions. 


3. Areas acquired by the program' during execution must be released' befo11e returning to the 
Automation' Options facility. Failure to follow this rule may result in 1 storage buildup, a 


situation that may lead to abends. 


4. CLISTs and REXX EXECs can be used under MVS/XA or higher level operating systems. 
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Client pI1ograms that are not of type TSOCP 011 EXECPGM are called AOP programs. A full 
description 0£ the execution pvocess of an AOP program is included in member 


DOCOAOCP in the SECUDATA libvary. 


Client Program Linkage Conventions 


Client programs which do not specify attributes NOSCREEN, TSOCP, 011 EXECPGM, 
return 
1 a set of lines to the Automation, Options facility. These lines are displayed 


accovding to the parameters specified in the foI1mat member referenced by the FORMAT 


statement in the menu definition· member. 


A full description 
1 ofi the Client Program Linkage Conventions fol' ani AOP program is 
included, in member DOCOAOCP in the IOA SECUDATA library. 


Considerations for When CONTROL-M and 
CONTROL-0 Are Installed 


When CONTROL-0 and CONTROL-M are installed, the CONTROL-0 monitov assumes 
the responsibilities 0£ both the CMEM facility and CONTROL-0. The way in1 which the 


CONTROL-0 monitor functions depends on how organizational requirements, scheduling, 
and automation have, until now, been addressed at your site. 


The following DD statements in the CONTROL-0 startup procedu!'e are relevant to this 
issue: 


DARULLST 


DACTMLST 


References a member containing the list of CONTROL-0 rule tables to be 
loaded by the CONTROL-0 monitor. The default name fov this member is 


RULELIS'r. 


References a member containing the list 0£ CMEM rule tables to be loaded 
by the CONTROL-0 monitov. The default name fol' this membel' is 


IOACMEML. 


Below is a description of the different ways in which the CONTROL-0 monitor can 
operate: 


• If aU automation' was implemented only via the Online CONTROL-0 Rule Definition' facility 
(and the CMEM facility was not used): 


Start CONTROL-0 via command, S CONTROLO. CONTROL-0 loads the rule tables listed 
in the member referenced by DJ]) statement DARULLST. The member referenced by DD 
statement DACTMLST must be empty. 


• If automation was implemented' via both the CONTROI:.-0 Rule Definition facility and the 


CMEM facility: 


Start CONTROL.-0 via command' S CONTROLO. CONTROLrO first loads the CMEM rule 
tables listed in the member referenced by DD statement DACTMLST. CONTROL-0 then 
loads the CONTROL-0 rule tables listed in' the member referenced by DID statement 


DARULLST. 
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• If automation was implemented via both the CONTROI:.-0 Rule Definition facility and the 


CMEM facility but, temporarily, only CMEM functionality is desmed (e.g;, for a trial, period):· 


Start CONTROL-0 via the following operator command: 


S CONTROL0,'1'YPE=C~OCMEM 


This command causes the CONTROL-0 monito11 to load only CMEM rule tables. 


CONTROL-0 loads the CMEM rule tables listed in the member referenced by DD statement 


DACTMLST. Loading 0£ CONTROL-0 tables is skipped. This mode 0£ ope11ation1 should not 
be used on a long-term basis. 


Moxie information on the management of the CMEM facility by the CONTROI:,-0 monitor is 
provided at the beginning of this section, 
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General 


This section describes the initialization and customization features that are available 
within CONTROL-B. 


CONTROL-B New Day Procedure 


The CONTROL-B New Day procedure (CTBNDAY1) perfo11ms certain automatic functions 
which sta11t a new day under CONTROL-B. It pe:rlo11ms daily clean-up operations on the 


CONTROL-B Active Balancing file and, optionally, other files .. It also orders (activates) 


CONTROL-B missions. 


The New Day p11ocedure can be activated automatically by a scheduler (e.g., CONTROL-M) 


at a p11edefi.ned· time each' day. It can also be activated manually by submitting a job or 
starting a started-task (STC). 


The supplied New Day p11ocedure activates program CTMILY. Program CTMILY reads the 
sequential dataset (011 member) referenced by DD statement DAPROG. This dataset 
contains a list ofi programs to be activated. 


The no:rimal sequence ofi p:riograms and utilities activated by the New Day procedure is:. 


CTBCHK 


CTBFRM 


CTBBAO 


CTBPDA 


Checks the current date and its relation to the General Date Control 
record (see below). The p11ogram. may communicate with the computer 


ope11ato11 to verify that CONTROL-B is activated on the right date. 


Reformats the Active Balancing file. Unnecessary missions are erased and 
the file is compressed. 


Places balancing missions in1 the Active Balancing file according to the 
date in the Date Control record and the scheduling specifications. 


Records the end 0£ the daily run. 


1 This name is defined during the installation process and may be different at your site. 
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Reformatting the Active Balancing File · Utility CTBFRM 


As explained above, the New Day procedure activates utility CTBFRM to clean up the 
Active Balancing· file. Utility CTBFRM reformats the Active Balancing file. Missions and' 
rules that have already executed and ended OK, and missions whose MAXWAIT 
parameter has been' exceeded, are erased foom the file; Unscheduled rules are 
automatically assigned a MAXW AIT value of: O; After these mission entries are erased, the 
Active Balancing file is comp11essed. 


Note 
If utility CTBFRM abends, information is recovered automatically after startup 
using an automatically-generated backup· copy· of the Active Balancing file named 
ABFBKP. For more information see utility CTBFRM in Section 9 of this guide. 


Scheduling Balancing Missions 


The second function performed by the New Day p11ocedure is the determination of which 


missions may potentially be activated on a specific date (i.e., which missions will be place 
in the Active Balancing file). 


Which missions will be scheduled depends on the wo11king date. See "Date Control Reco11d" 


below fo11 additional, information .. 


Date Control Record 


The CONTROL-B New Day procedure places mission entries in the Active Balancing file. 
The New Day p:r:ocedure usually runs once a day on one or: moxie balancing mission 
definitions. Mission1 orders are selected according to·the wo:r:king date specified to the New 
Day procedure. The New Day procedure is date-dependent and certain1 special situations 
must be handled. For: example: the computer hasn't been wo:r:king for a day or: more due to 
holidays, hardware failure, etc. 


To maintain1control1on•the last running date of the New Day procedure, CONTROL-Buses 


a special Date Control reco:r:d·. The Date Control' record is analyzed by the New Day 
procedure to determine the current running date, the last running date, and possible error: 


situations. 


In certain cases, it is possible to manually update the Date Control record using a regular 
editor. This affects scheduling acco:r:dingly. The Date Control, record is referenced by DD 
statement DACHK in the CTBNDAYp11ocedure. 
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Format of the Date Control Record 


Each Date Control1 reco11d is 80 characters long, and contains the following fields: 


Columns 


01-06 


18-23 


25-30 


50-55 


60-65 


67-72 


Item 


date-1 


date-2 


date-3 


date-4 


date-5 


date-6 


date-7 


Purpose 


Current (011 last) original scheduling date. 


Current (or last) original scheduling date of balancing 
missions using parameters DATES, DAYS, DCAL, and/or 


WCAL. 


Cur:rent (or last) original 
1 scheduling date 0£ balancing 
missions using the DATES, DAYS, DCAL and/or WCAL 


finish indicator. 


Current (or last) original' scheduling date of jobs using 
parameter WDAYS. 


Current (or last) original scheduling date of jobs using the 
WDAYS "finishindicato11." 


Last date the Active Balancing file was formatted by 


utility CTBFRM. This field prevents formatting from 
being performed twice on' the same day. If there are any 
problems concerning the date, the program presents the 
operator with a series of questions. 


"Finish indicator" date of the CONTROL-B New Day 
procedure. 


The fo11mat of the dates is determined by the date standard used at your site. 


Use of the Date Control Record by the New Day Procedure 


The workflow 0£ the New Day p11ocedure is affected by the Date Control, reco11d and the 
contents of the Date Control 
1 record are updated by the New Day procedure. The main 
steps o:Hhe New Day p11ocedure are: 


• Checking the last running date of the New Day procedure (via internal program CTBCNK). 


The first date inithe Date Control record (column 1-6) is compared to the current installation 
working date (at the time of the run). If they are identical, a message indicates that the New 
Day procedure has al11eady run today and the condition' code is set to 0004. 


If the current installation wo11king date is earlier than the first date 0£ the Date Control1 
reco11d, the New Day procedure stops executing and notifies the user that an attempt was 
made to run' a New Day p11ocedure before its time. 
If the current installation working date is later than, the fust date of the Date Control record, 
(the normal, situation) the first date of the Date Control record (columns 1-6) is updated 
automatically to. the current installation' working date which is then used by all components 
of the New Day procedure as the cu:r~rent scheduling date. 
If the New Day procedure did not run for mo11e than one day, a warning message is issued. 
and the New Day p11ocedure attempts to schedule balancing missions fo11 all of the days 
which have passed since the last scheduling date (according to the production parameters) .. 
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The program1 "asks" the operator a series of questions regarding the computer's current date. 
This ensures that an incorrect date was not inadvertently entered during !PI:,. 


• Placing balancing missions in the Active Balancing file acco11ding to. the current scheduling 
date and the last running date (via internal program CTBBAO), 


Programr CTBBAO acts on1 a user-defined balancing mission, table referenced' by DD 
statement DABAL. The p11ogram1 checks whether eachr missionr in' the table should be 
scheduled on1 one 011 an: the days that have passed since the last original scheduling date 
(date-3 011 date-5) until the current installationiworking date (date-1). If a mission should be 


scheduled~ it is placed in the Active· Balancing file. 


For example, if a computer did not operate from the 20th to. the 23td1 a mission: which was 
originally scheduled to· run on the· 20th did not run, Program: CTBBAO decides whether or 
not the mission1 should 
1 be retroactively scheduled to run1 on1 the logical date of the 20th, See 


parameter RETRO in Section,6 ofithe CONTROL-B User Manual. 


When: the program, finishes processing the mission' definitions, the "finish indicato11" dates 
(date-3' and date-5) are updated 
1 to the installation working date calculated by p11ogram 


CTBCHK (date-1). 


Befo11e program1 CTBBAO starts operating, it compares date-2 with date-3 and 1 date-4 with 
date-5. If they are not equal1 it probably means that a previous run1 of p11ogram. CTBBAO has 


abended. The user is notified and the p11ogram1 terminates .. To correct the erro11, you must 
alter the Date Control record to·the correct date values (using a standard editor); 


Note 
When manually modifying the Date Control recond, verify· that the same missions 
are not scheduled to run twice on the same day; 


• Recording the end of the Daily run: (via p11ogram1 CTBPDA). 


Program CTBPDA updates the "finish indicator" date (date-7) by placing in it the value of 
the current installation working date (date·l). This is used to indicate that the New Day 


p11ocedure finished, successfully. 


It is highly recommended that utility CTBJAFD!!J be run as the last step of the New Day 


p11ocedlll.1e. See Section1 9 in: this guide for more information about this utility. 


Invoking CONTROL-B (Runtime Environment) 


CONTROL-B rules ave invoked by the CONTROL-B Runtime environment. Therefore, the 
Runtime environment must be invoked in1 order to invoke a CONTROL-B rule. 


The CONTROI:..-B Runtime environment can be invoked by: 


• A direct call 


When the CONTROI:.-B Runtime environment is invoked by a di:vect call1 the name of the 
rule to be invoked· is one ofi the parameters passed in the calll. The dillect call to the 
Runtime environment can, come from an application1 p11ogram1 a job step, or another IOA 


product. The specified: rule name is sea:vched in the libraries referenced' by DD statement 
DAB RULE. No scheduling criteria are specified; the same rule is always. activated. 
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• A balancing mission 


A search is performed for the specified balancing mission name in1 the Active Balancing file. 
After locating the appropriate· mission, the rule specified' by the mission is activated. When 


CONTROI:.-B is invoked using this method, scheduling criteria can be specified for date 
dependent balancing activities. For example, the same mission: may activate different rules 
based on1 the day 0£ the week using different categories of the mission, 


These methods of rule activation are discussed' on the following pages. 


Passing Arguments While Invoking CONTROL-B 


Arguments can be passed when directly invoking CONTROI:.-B via procedure CONTROI:.B 


by specifying the· following in1 the JCL.. statements of the job step: 


II EXEC CON'l'ROLB,RUIIE=rule,GROUP=group,M:CSS:CON=mission,ARG=arglist 


Where: 


rule 


group 


mission· 


arglist 


Name of the rule to be invoked~ 


Group name o:Hhe rule to be invoked~. 


Mission' name of the rule to be invoked~ 


Arguments, separated by commas, to be passed to the rule. 


The arguments specified in· arglist are accessed via System variable RARGnn, where nn is a 
one- or two~digit number which represents the position of the argument in, arglist. To 
access the value o:f:the first argument in the list, specify RARGOl within a rule. 


Example 


The following sample JCL and rule definition' demonstrate how an argument can be passed 
1 
when invoking CONTROL-B. In· this case, the value PROIDl.COPY.FILEl is passed to 


CONTROL-B as an' argument. In CONTROL-B, this value is checked to indicate whether 
or not the dataset exists at the site. The JCL continues to run accol'ding to the result of the 


CONTROI:.-B activation. 


//CB.KTAPE 
JOB 
01ACCT,CLASS=A,MSGCLASS=X,COND=(O,NE) 


//CTB 
EXEC 
CON'l'ROLB1RtmE=RtJLDSN,ARG= 1 PRODl.COPY.P':CLEl' 


//COPYTAPE 
EXEC 
PGM=:CEBCOPY 


//SYSPR:CN'l' 
DD 


ll:CN 


//OUT 
II 
II 


//SYS:CN 


DD 


DD 


DD 


C 
O=OUT,:C=:CN 
II 


SYSOU'l'=* 


DSN=PROD.COPY.P':CLEl,D:CSP=SHR 


D:CSP=(NEW,PASS),DSN=COPY.P':CLEl, 


VOL=SER=TAPE18,UN:CT=TAPE, 


LABEL=(l,SL) 


* 
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L:CBRARY : CTB.PROD.RULES 


COMMAND ===> 


RULE : RULDSN 


SCROLL===> CRSR 


+-----------------------------------------------------------------------------+ 


OWNER 
M42A 


UPDATED 08/08/96 


DESC 


OPT:CONS 


12:19:37 


GROUP PROD1 


BY M42A 


=========================================================================== 
EXECUTE BLOCK1 
UPON 


ON DATA 
c 


:CF 
:CSDSN ( ',_.,,..oRARGO 1 ' ) 
c 


DO TERM:CNAT 
OK 
COD 0000 


ELSE 


DO PR:CNT 
= F:CLE %%RARG01 DOES NOT EX:CST 
F 
C 


DO TERM:CNAT = NOTOK 
COD 0008 


=========================================================================== 
EXECUTE 


ON 


UPON 
c 


=======>>>>>>>>>>>>>>>END, OF RULE DEF:CN:CT:CON PARAMETERS<<<<<<<<<<<<<<<===== 


PLEASE F:CLL :CN RULE DEF:CN:CT:CON 
13.25.00 


Invoking CONTROL-B Via a Direct Call 


The CONTROL-B Runtime enrnonment canibe invoked by a direct calllfrom any of the following: 


Application program 


Job step 


The name of the rule to be invoked is specified by the application 


programis calll to CONTROL-B. See Appendix C ofi the CONTROl.-B 
User Manual for additional1information. 


Format 


CALL CONTROLB{<rule name>) 


The rule to be invoked is specified by the JCL statement of the job 
step (in the balancing job). This is the most frequently used method. 


Format 


I I EXEC CONTROLB,RULE=rulename,GROUP=group,ARG= (argl, .•. argn). 


Note 
The GROUP specification is mandatory only if parameter 


GROUP in the rule definition was omitted. Otherwise (i.e., 
parameter GROUP was specified in the rule definition), the 


GROUP specification is optional. 


The ARG specification allows up to 50 arguments. See "Passing 
Arguments while invoking CONTROl!.-B" below. 


Another IOA p:rioduct 
The rule to be invoked is specified by parameter DO CTBRULE in a 


CONTROL-Mjob scheduling definition or a CONTROL-D decollating 
mission definition~ 
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When CONTROL-B starts p11ocessing, it searches for the specified rule in the libraries 
referenced by DD statement DABRULE .. 


If the rule is found,.it is invoked. If the rule is not found,. a runtime error occurs. 


This flexibility enables the CONTROL-B use11 to select one or more app11opriate points in 
the life cycle of a particular data source during which balancing activities should be 


pe11formed. For example: 


1. CONTROL,-B can be invoked befo:r~e the creation of a repol1t to check the validity of the 
report job input. 


2. CONTROl!,-B can be invoked befo11e updating a database (e.g., a DB2 table) 011 an important 
file in the system •. CONTROL-B checks the validity o£the input used for the update. 


3. After a repol1t is created, it can1 be checked during the cur:rent job - before executing other 
steps in the job and before the report is distributed. 


4. CONTROl!,-D can invoke a CONTROL-Brule to validate a decollation process. 


5, During out-p1mcessing in CONTROL-M, CONTROL-B can be invoked to control, a job flow, 
or to perfo11m balancing actions which verify the results of ajob run, 


Invoking CONTROL-B From a Job Step or Application 
Program 


The following parameters can be used to invoke CONTROL-B from a job step or from an 
application program: 


• RULE 


• MISSION 


• GROUP 


• ARG 


Parameters RULE and MISSION cannot be specified together to invoke balancing 
operations (i.e., the user must decide whether CONTROL-B should be invoked directly or 
indirectly). Either the mission name or rule name should be specified but not both. 


The group name is dete11mined as follows: 


1. If GROBP is specified in the invocation, that group name overrides any other group 
specification. 


2. If GROUP is not specified in the invocation, the group name of the mission is used (if 
balancing operations are invoked by a mission~. 


3. Otherwise, the group name specifiedin 1the rule definition is used as the current group. 


Note 
The specified group must already be defined in the CONTROL-B repository; 
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User parameters can be passed to a CONTROL-B rule and accessed by the rule via system 
variable RARGnn, where nn1 is a one- or two-digit number which represents the position of 
the argument in the argument list. To access the value of the first argument in the list, 
specify RARGOl withfu a rule. 


Examples oE Job Step :Cnvocation 


Direct invocation of a CONTROL-B rule: 


II EXEC CONTROLB1Rt1LE=ACC'l'CHK,GROUP=ACCT,ARG='12106/96' 


CONTROL-B invocation via a missionc 
II EXEC CONTROLB1M:CSS:CON=AC'l'M:CSS 


Application, p11ogram invocationc 


CALL·CONTROLB,(ruJ.ename,mission,groupname,resu1t,agument-count,argument-li:st} 


See the beginning of: this section for more information about CONTROb-B invocation. 


Invoking CONTROL-B by CONTROL-M 


When CONTROL-B is invoked by CONTROL-M, it is not necessary to specify scheduling 
criteria for the rule (i.e., there is no need to define a balancing mission> because the 
scheduling of the rule is determined by the scheduling specified, in, the CONTROL-M job 
scheduling definition, 


Parameter GROBP is determined as follows: 


• If a group name is specified in the CONTROL-M job scheduling definition, the CONTROL-M 


group specification overrides any other group specification' 


• If a group name is not specified: in the CONTROL-M job, scheduling definition, the group 
specified in the CONTROL-B rule definition. is used as the current group. 


A group must be specified in the CONTROL-M job scheduling definition' so that the 


CONTROL-Mjob, and the CONTROL-Brule are logically associated with each, other. The 
group in, the CONTROL-B repository is determined, outside of the rule by the group 
specified in, the calling CONTROL-M job 1 scheduling definition, 


Invoking CONTROL-B by CONTROL-D 


When CONTROL-Bis invoked by GONTROL-D, it is not necessary to specify scheduling 
criteria for the rule (i.e., there is no need to define a balancing mission) because the 
scheduling of: the rule is determined by the scheduling specified in the CONTROL-D 


decollating mission definition, 


Parameter GROBP is determined' as follows: 


• If a group name is specified in, the CONTROL-D decollating m1ss1on definition, the 


CONTROL-D group specification1overrides any other group specification, 


• If a group name is not specified in the CONTROL-D decollating mission' definition, the 
group specified in the CONTROL-Brule definition:is used as the current group. 
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It is highly recommended, that a group be specified in the CQNTROL-D decollating mission 
definition (using the SCHED command in the Decollating Mission Definition. screen~ so 


that the CONTROL-D decollating mission definition and the CONTROL-B rule will be 
logically associated with each other. The group in1 the CONTROL-B repository is 
determined outside of the rule by the group specified in the calling CONTROL-D 


decollating mission1 definition, 


Invoking CONTROL-B With Balancing Missions 


Balancing missions can be used to invoke CONTROL-B from one of the following: 


Application program 
Name of the mission to invoke is specified by a program call to 


CONTROL-B in, the application, program, See Appendix C in the 


CONTROL-B User Manual for additional: information. 


Job step 


Example 


CALL CONTROLB(<mission1>, ••• ) ; 


Name of the mission: to be invoked is specified in, the JCL statements 
of the job step (which invokes the CONTROL-B 
Runtime 
environment). 


Example 


II EXEC 
CON'l'ROLB, 


II 
M:CSSION=DAJ:LYBAL,GROUP=group,ARG=(argl, ••• ,a:rgn) 


Note 
The GROUP specification is mandatory only if parameter 


GROUP in the rule definition was omitted~ Otherwise (i.e., 
parameter GROUP was specified in the rule definition), the 


GROUP specification is optional. 


The ARG specification allows up to 50 arguments .. See "Passing Arguments While Invoking 


CONTROL-B" above. 


When the call/step which invokes CONTROL-B is invoked, CONTROI:,-B first checks each 


entry in the Active Balancing file to locate the appropriate balancing mission. The Active 
Balancing file search method consists of the following phases: 


Phase 1 


Phase 2 


AU mission entries with coNesponding mission names we checked to see 
if thei:r1 runtime scheduling criteria we met. Missions whose runtime 
scheduling criteria are met advance to the second phase for further 


checking~ 


Missions which have passed the first phase are checked to see if the 
values specified by paxameters JOB and STEP match the job name and 


(optional~ step name of the current callfstep: 


Note 
The * mask character can be specified at the end of JOB and 


STEP names. 
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Parameter SCOPE 0£ each eligible mission' entry in1 the Active Balancing file is checked to 
determine a JOB/STEP match. Parameter SCOPE specifies one 0£ the following options: 


SINGLE 


STEP 


JOB 


ALL 


If JOB and 1 STEP values match, the mission, entry is eligible for further 
checking only if it has not been, invoked before. Optioni SINGLE 


guarantees that this mission entry is only invoked once - by a single 


CONTROL-B invocation, 


If JOB and STEP values match, the missioni entry is eligible for further 
checking if it has not been invoked before, or it was previously invoked by 
the current STEP in the current JOB. Option STEP enables the mission 


entry to 1be invoked repeatedly, provided that the mission1entry is invoked 
from the same job step each time ( e.g~, from an application program1 that 
invokes CONTROL-B fromwithin:a loop). 


If the JOB value matches, the mission, entry is eligible for further 


checking if it has not been, invoked before, or it was previously invoked by 
the current JOB. Option: JOB enables the mission entry to be invoked by 
several CONTROL-B invocations, provided that the invocations all! 


originated from the same job. 


The mission entry is always eligible for further checking~ Option ALL 
enables the mission entry to be invoked regardless of the JOB and STEP 


that previously invoked the mission entry. 


The first mission that matches the above criteria is selected for execution. If no· matching 
mission is found, a runtime errov occurs. 
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General 


This section describes how the different components and files of CONTROL-T are 
activated, controlled, and maintained on a regular daily basis .. The following topics are 
discussed in this section:. 


• The CONTROL-T Real-Time Envi:t~onment 


• New Day Procedure 


• Repository Structure 


• Repository Maintenance 


• Repository Backup and Recovery 


• Robotic Library Support 


• Cartridge Message Display Customization 


• External' Data Manager Support 


• DF/SMS Support 


• Dynamic Dataset Stacking Facility 


• CONTROL-T Applfoation Programming Interface 


Some administrative tasks are perforoned via CONTROL-T utilities. The available utilities are 
described in detail in Section 9 of this guide. 


Additional customization and some security can be implemented via CONTROL-T exits. 
The available CONTROL-T exits are described in Section 10 o:t:this guide. 


The CONTROL-T Real-Time Environment 


The Real-Time Environment of: CONTROL-T is established during the Initialization 
process. 


Once the Real-Time Environment is established, CONTROL-T takes control of tape 
volumes processed in the system. This is accomplished by the MVS interfaces of 


CONTROL-T. CONTROL-T performs extensive validity checks to ensure the data 
integrity of: the media library at the site. In addition, stacking can be performed: for 
non-specific· mount requests. 


As a dataset moves through the system, CONTROL-T gathers relevant information, 
searches rules to determine the required actions (such as retention and vaulting 
information), and updates the Media Database. 


These topics are described on the following pages. 
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Initialization 


The first step in' using CONTROL-Tis to initialize CONTROL-Tin each CPl'.J. This is done 
by starting p11ocedure CTTINIT, and is usually perfo11med as pa11t 0£ the IPL p11ocess. The 
initialization p11ocess establishes the CONTROL-T Real~Time En:vironment, acco11ding to 
the following steps: 


• Creates the main:CONTROI!.-T Control Table .. 


• Loads rule tables, pool1 definitions, and vault definitions into common storage .. 


• Opens the files necessary for the R€al+-Time Environment: The Media Database, Trace and 


Stacking Statistics files. 


• If requested by the user, loads and· defines the CONTROL-T SVC (the SVC number is 
specified as an installation parameter). 


• If requested by the user, establishes interfaces between CONTROL-T and MVS by setting 
intervention points in MVS where CONTROL-T obtains control. These interfaces remain 
until a termination process is run. 


• Establishes the WTO (Write to Operator) Intercept so that mount messages can be 
modified. 


• Initializes the subsystem for handling stacking and other functions. 


The block of info11mation in common' sto11age containing key control1 data and· pointers is 
referred to as the CONTROL-T Control Table (TCT). Its common storage address is used 
by all real-time components (e.g., the CONTROL-T SVC and the subsystem) and certain 
other components (e.g., EDM controlled datasets). All' activity starts from this block, and 
the block contains pointers to all CONTROL-T tables and modules in storage. The control 
block, along with its related routines, remains in common storage until CONTROL-T is 
shut down. 


Upon completion of the initialization, process, CONTROb-T's Real-Time Environment is 
established and CONTROL-T takes control: 0£ removable media processing. 


After initialization; no address space is needed fo11 the CONTROL-T Environment. 


Procedure CTTINIT 


The CTTINIT p11ocedure controls the initialization, termination, and operation 0£ 
CONTROL-T. The following operator command invokes the CTTINIT procedure: 


S CTT:CN:CT,PARM='MODE=xxxxx[.,DBGLEVEL=nnn,DBGJOB-xxxxxxxx]' 


The parameters of this command are described in detail below. The PARM field can 


contain one 0£ the following values: 


Note 


7-2 


The MODE keyword can be 
omitted~ For example, PARM='MODE=INIT' and 
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Parameters Relating to Initialization/Termination/Refreshing 


MOBE=INIT 


MODE=TERM 


MODE=RELOAD,EXIT=exit 


MODE=RELOAD,TBLT=RULE 


MOBE=RELOAD,TBLT=POOL 


Initializes CONTROL-T. For details oni how CONTROL-T 


is initialized, refer to "Initialization" in Section 1 of the 


CONTROL-T User Manual. This command must be 
issued on each ~S system in which CONTROL-Tis to 
be activated. 


Terminates CONTROL-T. This command must be issued 
on each MVS system in which CONTROL-T was 
activated. 


Loads a new copy of a CONTROL-T exit without the need 
to restart CONTROL-T. Specify the fulll name ofi the exit 
module, e.g,, CTTX004. 


Note 
Reloadable exits are: 
CTTX002; 


CTTSE03, 
CTTX004, 
CTTSE04, 
CTTX006, 
CTTSE06, 
CTTX009, 
CTTXOl 0, and IOAX035. 


CTTX003, 


CTTX005, 


CTTSE09, 


When CONTROI:.-T is initialized, it reads a list of rule 
tables from the member referenced by DD statement 


DARl:JLLST in procedure CTTINIT. The supplied default 
member RULLIST is in, the CONTROL-T PARM Libvary. 


For every lfue in the list, CONTROL-T loads the specified 
rule table from the specified libvary. 


To replace all currently active rules with a new (updated) 
copy of the rules, issue the following operator command: 


S CTTJ:NJ:T,PARM='MODE=RELOAD,'l'BLT=RULE' 


When CONTROL-Tis initialized, it reads pool definitions 


from the member referenced by DB statement DAPOOLS 


in procedure CTTINIT. These pools ave defined via the 


CONTROL-T Pool Definition screen. 


If you modified or added pools and you want to replace 
the currently active pools with a new (updated) copy ofi 
the pools, issue the following operator command: 


S CTTJ:NJ:T,PARM='MODE=RELOAD,TBLT=POOL' 


MODE=RELOAD,TBLT=VAULT 
When CONTROL-T is initialized, it reads vault 
definitions from1 the member referenced by DD statement 


DAVLTS in' procedure CTTINIT. These vaults are defined 
via the CONTROL-T Vault Definition screen. 
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If you modified· or added vaults and you want to replace 
the currently active vaults with a new (updated) copy of 
the vaults, issue the following operator command: 


S CTTJ:NJ:T,PARM='MODE=RELOAD,TBLT=VAULT' 


7-3 


Section 7: Customizing and Administering CONTROL-T 


MODE=RELOAD,TBLT=PARM 
The following CTTPARM options can be modified while 


CONTROI.-T is active. There is no need to shut down 


CONTROL.-T. 


ABENDACT 
EXPDTDDN 
RECREATE 


BLPBEF 
EXPDTYPE 
RTNUPD 


CNGMSG:ID 
EXTRNVOL, 
SCRPROT. 


DAYTIME 
LBLROUTC 
SMSINTR 


DEF ABEND 
MOBE 
STKDEFFT 


DEFEXPBT 
MSGFMT 
STKSRCHL 


DSNMCHK 
NLASKOP 
STKTEST 


DYNDS 
OVERJCL 
VLTBYDSl 


DYNSTYP 
RBTTYPE 
X98ASKOP 


DYNVOL 


To· modify' these options, run job CTTP ARMJ. to create a 
new CTTP ARM module. Then issue the following operator 
command: 


S CTTZNZT,PARM='RELOAD,TBLT=PARM' 


Parameters Relating to MVS Interfaces 


MODE= VERIFY 


MOBE=CHECK 


Verifies that CONTROL-T MVS interfaces can be applied 
and the SVC can, be installed~ 


This mode can1 be used during CONTROL-T installation, 
or when bringing up a new MVS version, to determine if 


CONTROL-T can be initialized, 


Checks if CONTROL,.. T MVS interfaces are already 
applied and the SVC al11eady installed. 


Because CONTROL-T has no active address space (job or 


started task) in, the system, this mode is used to 
determine if CONTROL-Tis up. 


VERIFY can be executed only if the CONTROL-T real-time environment is not active. 


CHECK can be executed whether or not CONTROL-T is active. 


Parameters Relating to Operating Status 


MODE=DORM 
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Makes CONTRO:I:.-T temporarily do11mant. Afte11 this 
command. is issued, CONTROL-T does not intervene in 
any job, does not check expiration· dates, etc; 


The CONTROL-T envi11onment (CONTROL-T tables, 
rules, 110 control blocks, etc.) is saved. 
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MODE=SUSI?END 


MODE=RESUME 


MODE=STOPSTK 


MODE=STARTSTK 
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Temporarily suspends removable media activity. After 
this command is issued, all jobs which access removable 
media wait for an operator reply specifying how to 


proceed, The operator can specify that processing should 
continue without CONTROL-T, should wait for a 


RESUME command, or should abend. 


The CONTROL-T environment (CONTROL-T tables, 
rules, 1/0 control: blocks, etc.) is saved. 


Causes normal CONTROL-T operations to resume after 


MODE=DORM or MODE=SUSPEND commands are 


issued, 


Stops the Dynamic Stacking facility. 


Starts/restarts the Dynamic Stacking facility. 


Problem Resolution Parameters 


Note 
The following parameters should only be used if requested by your JOA representative 
or Technical Support. 


DBGLEVEL 


DBGJOB 


Debug level. A numeric value from Oto 255 can be specified. 


0 


1-255 


No debug messages are printed. 


Debug messages are printed. 


Name of the job for which debugging should be enabled, If DBGJOB is 
not specified, or DBGJOB=ALL is specified, debugging is enabled for all 
jobs. 


Sample JCL for procedure CTTINIT can be found in the CONTROL-T Procedure Library. 
The following DD statements are important for managing and maintaining CONTROL-T: 


DARULLST 


DAPO<DLS 


DAVLTS 


References a member which contains a list of the rules that should be 
loaded upon initialization/reload, 


Example 
* 
CTT.VSOO.RULES 


* 
CTT.VSOO.RULES 


BKPRULE 


SAVRULE 


ORDER 


ORDER 


For additional information see "Loading of Rules" below. 


References a member that contains pool definitions. By default, this 
member is $$POOL in the PARM Library. Several pool definition 
members can be concatenated and specified with this Dr> statement. 


References a member that contains vault definitions. By default, this 
member is $$VAULT in the PARM Library. Several vault definition 
members can be concatenated and specified with this DD statement. 
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Loading of Rules 


When, CONTROL-Tis started (011 rules need to be re-loaded), CONTROL-T attempts to read, 
a list of rule tables from the member referenced by D:ID statement DARULLST. These rule 
tables are automatically loaded by CONTROL-T. The supplied default member RULLIST is 
in the CONTROL-T PARM lib11ary. Each line in the list has the following fo11mat: 


date library table operation 


Where: 


date 


library 


table 


operation 


The date of the rule table .. If a specific date is designated, it is used to 
analyze the Basic Scheduling paJ.1ameters (see below:). The date fo11mat is 
mmddyy, ddmmyy, 011 yymmdd,(dependingon 1the site standard). 


Specifying an1 asterisk(*) indicates the cu11rent CONTROL-T Installation 


Wo11king Date. 


Name of the lib11ary in which the rule table is located~ 


Name of the rule table. 


Operation to be performed. on the rules in the specified, table .. Valid, 


values a11e: 


ORDER 


FORCE 


Each rule's Basic Scheduling parameters a11e compared to 
the 
specified 
date 
(or the 
current 
CONTROL-T 


Installation Working Date·wheni *is specified). If the rule 
should be scheduled on that date, the rule is loaded by 


CONTROl!,-T and, activated~ Default. 


Each rule is loaded by CONTROL-T and activated. Use 
the FORCE option when you do not want to use 


CONTROL-T scheduling options. 


For every line in the list, CONTROL-T loads the specified rule table from the specified 
library. 


Termination 


CONTROL-T should be in operation from computer startup to shutdown (i.e., all the time) 
so that it can intercept all removable media management activities. Information about 
jobs which access removable media while CONTROL-Tis inoperative, is not recorded. 


When CONTROL-T is terminated, a check is triggered for active jobs which access 
removable media in the system, If such jobs exist, the operator is prompted to cancel the 
termination, retry the termination, or continue (fo11ce) the termination. 


When CONTROL-Tis terminated, all traces of the CONTROL-T Real-Time Environment 


are removed from the system, including the following: 


• Interfaces established between CONTROL-T and MVS (i.e., intervention points in1 MVS) are 
removed. 


• The CONTROl!,-T SVC is removed from the system, 


• The WTO Intercept is disabled; mount messages al'e no longer modified~ 
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New Day Procedure 


The New Day procedure is the primary mechanism used to perform daily maintenance on 
the CONTROL-T Media Database and related files. 


The New Day pnocedure, called CTTDAY, can be activated: automatically by a scheduler 
(e.g., CONTROL-M) at a predefined time each day. The New Day procedure can also be 
activated manually by submitting a job. 


New Day Functions 


The maintenance operations illustrated and described below are performed by the New 
Day procedure: 


New Day Processing1 


CheckCTT 
Operation. 


Mode 


Rule 
Refresh 


Retention 
Phase 


Vault 
Phase 


Stacking' 
File 
Phase 


MDBand 
Trace 
Backup. 


CheckMDB 
Integrity 


1 The order of processing may be changed in certain situations. 
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Memory 


Active 
Environment 


Memory 


Active 
Rules 


SCRATCH 
LIST 


n------+t DISTRIBtrTION 
REPORT 
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Check CONTROL-T 


Operation' Mode 


Rule Refresh 


Retention Management 


Vault Management 


Stacking Statistics File 
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Procedure CTTINIT (with MODE=CHECK specified) checks 
whether or not CONTR0L-T is active, and whether or not 
Dynamic Dataset Stacking is operational, This step also checks 
the expiration, date of the specified password• 


Procedure 
CTTINIT 
can 
1 
be 
invoked 
with 
parameter 


MODE=RELOAD to refresh CONTROL-T's active rules. The 
user should consider whether or not this step should be included 
in the New Day procedure .. The follbwing are some 
considerations that should be taken into account: 


1. Rules are automatically refreshed when CONTROL-T is 
initialized (usually when an IPI.:, is performed). If a rule 


definition.is changed (in: the Definition Library), the modified 
definition takes effect only when, the next IPL is performed 
(monthly, weekly, etc.). 


2; The retention management and vault management utilities 
optionally load rules from the library as their first step. In 
this case, all subsequent retention and vault decisions are 
based on refreshed rules. 


While these utilities may operate with new, refreshed rules, 
the CONTROL-T Real-Time environment continues to use 
the older, original rules in memory. 


To avoid confusion over which rule definitions are being 
accessed, the user can, implement the Rule Refresh option at 
any time. Because of this situation, a rule refresh step is 
usually performed as the first step of the New Day 
Procedure .. 


3. CONTROL-T's 
Rule 
Scheduling facility 
(enabled 
by 
specifying Scheduling parameters while defining rules) 
allows you to define when: rules should be activated based on 
calendars and scheduling criteria; For example, this allows 
you to speciey a different retention period for the same 
dataset when that dataset is created on weekdays and 
weekends. 


Utility CTTRTM scans the Media Database and determines 
which volumes/datasets have expired'. These volumes are 
marked as scratch1 volumes in the CONTROI:.-T Media 
Database. 


This utility can produce various reports concerning the current 
status of scratch volumes in' the Media Database. 


Utility CTTVTM determines which volumes should be moved 
and the locations to which they should be moved. This utility 
can also produce a distribution' report. 


Utility CTTSTK updates the Stacking file with new statistics 
collected on each dataset. This utility uses data from the Trace 
file .. 
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Media Database Backup. 


Check Media Database 
Integrity 
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This backup consists of the following steps: 


1. Writing a Started Media Database Backup record, to the 
Trace file. 


2. Backing up the Media Database data file and the Trace file 
using any standard backup utility. In.the suppliedjob, utility 
IEBGENER is used for the backup. 


3. Writing an' Ended Media Database Backup record to the 
Trace file. 


This backup can be used if a Media Database resto11e is 
required. See "CONTROI:..-T Database Backup And Recovery" 
later in· this section. 


Utility CTTIDB is run to check the Media Database fon integrity 
errors. See utility CTTI'DB in: Section 9 for more information, 


Repository Structure 


The CONTROL-T Repository is composed 0£ the following files: 


• Media Database 


• Trace file 


• Stacking Statistics file 


Media Database Structure 


The CONTROL-T Media Database is composed of the following primary physical files:. 


• Data file 
. Contains aU required data about volumes and datasets in the 
Media Database. 


• Index file 
Provides keyed access to data in the Data file. 


Note 
Another file, the Trace file, is used to track updates and facilitate recovery of the 
Media Database. (See "Structure of the Trace File" later in this section for more 
information.) 


The Data and Index files are allocated via the following DB statements: 


• Data file 
DD statement DAMDB 


DID statement DAMDI 
• Index file 


Note 
Although these files are sequential and may be read using standard MVS QSAM 
services, the structure or format of these files may change in future releases. Therefore, 
it is highly· recommended that the Media Database be accessed only via the standard 
macros described in "CONTROL-T Application Programming Interface" later in this 
section. 
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Data File Contents 


The Data file contains all the data about any volume or dataset. In CONTROL-T, unlike 
other tape management systems, volume information and dataset info11mation are sto11ed 


in the same file, but with different reco11d types and formats. 


The two most common record types in the CONTROL-T Data file a11e: 


Volume record 
Contains information regarding avolume. 


Contains info11mation regardfug a dataset. 
Dataset record 


Note 
Additional record types and formats exist in the database but are not described in this 
section because they are not relevant for most users. 


Volume and dataset reco11ds are mapped via Assembler macros CTTDVL and CTTDIDS, 


respectively. 


All reco11d types in the Data file have a common' header at the beginning of the record. 
This header contains the following info11mation, about the reco11d: 


Record in the Data File 


RB A Record Status Indicator Record Type 
Additional 
Fields; .. 
b b r 
A or F 
V or, D 


..____ 
......... ._ ......... ----... ---------------~- "- 
,,,,,, 
~ 
.._ ........... 
~~------- 


RBA 


Common 
1 Header 


Information 
Vo I um e Record or Dataset 
Record Information, 


Specifies the internal: reco1d location1 identifier (explained later). 
Each reco11d in the Data file is assigned an RBA that indicates 
the location' of the reco11d in the Data file. Access to a specific 
Data file reco11d can be performed via its RBA if known (011 via 
the index, as explained later in, this section). Access of a data 


record via its RBA is known as "non-keyed access." 


Record Status Indicator 
Indicates whether the record is active 011 free. 


Record Type 
Indicates whether the reco11d is a volume or dataset reco11d. 


Note 
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The term RBA as used in this section should not be confused with the term Relative 
Byte Address as referred to in IBM literature. The format of the CONTROL-T RBA is 
bbr. The first two bytes identify· the block number in the Data file and the last byte 
identifies the record number in that block. 
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Fields in the Data File 


Some of the mor:e important fields in the volume and dataset records in the Data file are 
listed below. Each field is assigned. an internal name (a symbol· in' a DSEC which describes 
the record), and an external name (a logical name used by the user in 


INCLUDE/EXCLUDE statements). A comprehensive list of these fields can be found in 


"Logical Field Names for the CONTROL-T Repository" in Appendix D and in the IOA 


MAC lib11ary. 


Commonly Referenced Volume Record Fields 


DVLRBA 


DVLRID 


DVLRTYPE 


DVLSTAT 
DVLSTA2 


DVLFLGl 


DVLVOLSR 


DVLLTYPE 


DVLACTD# 


DVLLBLNM 


DVLVSEQ 


DVLNEXT 


DVLPREV 


DVLFIRST 


DVLRBA 


DVLRID 


DVLRTYPE 


VOLSTAT 
VO LIND 


VOLFLAGS 


VOLSER 


LBLTYP 


ACTIVEDS 


LBLNUM 


VOLSEQ 


NEXTVOL 


PREVVOL 


FlRSTVOL 
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RBA of the record. 


Record status (A-Active, F-Free). 


Record type CV-Volume record). 


Various status and· flag bytes. 


Various status and flag bytes. 


Volume serial number. 


Label type 0£ the volume. 


Number of active (non-expil'ed) datasets on the 
volume. 


Label number of the last active dataset on the 
volume. 


Volume sequence number for a volume that is part of 
a multi-volume chain, 


Next volume (o£the multi-volume chain). 


Previous volume (o:Hhe multi-volume chain). 


First volume (of the multi-volume chain~. 
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Commonly Referenced Record Fields 


DDSRBA 


DDSRID 


DDSRTYPE 


DDSSTAT 


DDSFLGl 


DD SD SN 


DDSLBLNM 


DDSVOLSR 


DDSVOLS# 


DDSRBA 


DDSRID 


DD SR TYPE 


DSSTAT 


DSFLAGS 


DSNAME 


DSLABEL 


DSVOLSER 


VOLSNUM 


RBA of the record. 


Recol'd status (A-Active, F-Free). 


Record type (D-Dataset record). 


Various status bytes 


Various flag bytes. 


Dataset name. 


Label number (dataset sequence number on the tape). 


Volser ofi the dataset (or the first volser ofi a 
multi-volume dataset). 


Number of volumes in the dataset (if the file spans 
multiple volumes). 


Index File Contents 


The Index file makes keyed access of records in the Data file possible. The Index file 
contains recol'ds which, in turn, contain index elements. Each index element contains the 
following information: 


Index Element 


Key 
Type 
Key 


Key Type 


Key 


RBA 


Additional info 


Key Types 


Additional·· 
lnfcmnation 


RBA 
b b r 


D,V, or L (see "Key Types" below). 


Information which used to identify a record in the data file). Each index 
element contains one key only. 


Internal record location identifier ofi the relevant record in the Data file. 


Bytes used fo11 reposito11Y handling mechanisms. 


Each index element contains a particulal' type ofi key which is used fo11 accessing records 
in the data file. 


FuU and partial' keys of each1 type, are described below: 
v 
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Used to index volume records in1 the Data file. One index element 
containing one V-type key is created for each volume record in the Data 
file. The fuU V-type key for each volume record is the full volume serial 
number. This is a unique key. 
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Index to dataset reco11ds in the Data file. One index element containing 
one D-type key is created for each dataset reco11d in the Data file .. The fulll 


D-type key for each dataset recovd is the full dataset name. Because 
duplicate dataset names may exist in the media library, this is a 
non-unique key (i.e., more than one index element may exist with the 
same D-type key). 


Index to dataset records in the Data file .. An, element with an L-type key 
is created for each volume on which a specific dataset resides. For 
example, if a dataset recovds indfoates that the dataset spans three 
volumes, twee L-type keys (one for each volume) are created to reference 
that dataset reco11d~ The fulll L-type key in comprised 0£ the full volume 
serial' number and the full file sequence number (label) of the dataset on 
the volume. This is a unique key. 


Depending on the function' being perfovmed when accessing the Index file (described later 
in this section~, specification of the full key or a partial key may be specified. 


A partial key is a key which is shovter than the full length of the key in the index file. The 
most common usage of a partial key is the specification' of a prefix (e.g., dataset name 
prefix instead of a full dataset name). Partial keys can also be used when all necessary 
information is not available. 


All index elements have the same fixed length, which is determined by the index elements 
with D-type keys because the D-type key is the longest fuU key (i.e., the dataset name). 


It should be noted that index element length exceeds the length of the longest key because 
index elements contain additional bytes which, are used by the CONTROL-T Repository 
handling mechanisms. 


Index elements with V-type keys are mapped via assembler macro CTTDVX. Index 
elements with D-type keys are mapped via assembler macro CTTDDX. Index elements 
with L-type keys are mapped, via assembler macro CTTDLX. 


Volume/Dataset Relations 


The Media Database contains a record for each volume and for each dataset (in the Data 
file). Fields in these records, and indexes of various types, are used to describe the 
relationships between a volume and its respective datasets. These fields and indexes also 
describe the relationship between volumes in a multi-volume chain. 


The examples below show the relationship between, the relevant fields in the volume 
records, dataset records, and' the index elements that reference these records. 
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Example 1 


This example shows the reco11d and, index configuration for a single volume (VVV) 


containing only one dataset (called A.B). 


Media Database 


Data File 
Index File 


Volume·Record; 


VOLSER=VW 
VOLSEQ= 1 
V•type KEY 
LBLNUM = 1 
I 
I 
ACTIVEDS= 1 
vvv 
~ 
I 
. . . 


Dataset Record 
D-type KEY 


DSNAME = A.B · 
I 
A.B 
I 
I 
DSLABEL= 1 


DSVOLSER = VW 
VOLSNUM= 1 
L-type KEY 
I 
VVV01 l 
,.... 
I 
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Example 2 


This example shows the record and index configuration for a single dataset (A.B) that 
spans two volumes (VVV and XXX). 


Media Database 


Data File 
Index File 


Volume Record 


VOLSER=VVV 
VOLSEQ= 1 
I 
V-type KEY 
LBLNUM = 1 


ACTIVEDS= 1 
I 
I 
FIRSTVOL = \JVV' 
~ 
l 
WV 
NEXTVOL = XXX 


PREWOL= 
. . . 


j Volume Record l 


VOLSER=XXX 
VOLSEQ=2 
LBLNUM = 1 
V-type KEY 


ACTIVEDS= 1 
I 
I 
FIRSTVOL = VVV 
xxx 
NEXTVOL = XXX 
"" 
l 


PREWOL= 
. . . 


Dataset Record 
D-tvoe KEY 


I 
A.B 
I 
~ 
I 
DSNAME =A.8 


DSLABEL = 1 
L-type KEY 


DSVOLSER = VVV 
I 
VW01 
I 
VOLSNUM = 1 
I""' 
l 


L-type KEY 


I 
XXX01 
I 
I 
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Example 3 


This example shows the record and index configuration for a group of datasets (A.B, A.C, 
and A.D) contained in a multi-volume chain' (volumes VVV and X:XX). Dataset A.B resides 
on volume VVV. Dataset A.C starts on 1 volume VVV and, continues on1 volume XXX. 


Dataset A.D resides on' volume XXX. 


Media Database 


Data File 
Index File 


xxx 
V-type KEY 


Volume Record ! 
Volume Record 


VOLSER=VW 
i-- 
VOLSER=XXX 
VOLSEQ= 1 
VOLSEQ=2 
LBLNUM = 1 
LBLNUM = 1 


ACTIVEDS= 1 
ACTIVEDS= 1 


FIRSTVOL = VW 
FIRSTVOL = VW 
NEXlVOL = XXX 
NEXlVOL = XXX 


PREWOL= 
PREWOL= 


I 
WV 
v .. type KEY 
I 
. 


~ 


Dataset Record 


DSNAME=A.B 
A.B 
D-type KEY 
DSLABEL= 1 


DSVOLSER= VW 
VVV01 
L-type KEY 
VOLSNUM = 1 
Dataset Record 


DSNAME=A.C 
DSLABEL=2 
I 
A.C 
D-type KEY 
~ 
I 


Dataset Record 
DSVOLSER = VW 


L-type KEY 
VOLSNUM= 1 
VVV02 


DSNAME=A.D 
. 


DSLABEL=3 
" 
XXX02 
L-type KEY 
DSVOLSER = VW 
VOLSNUM = 1 


' 
A.D 
D-type KEY 


XXX03 
L-type KEY 
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Structure of the Trace File 


The Trace file is used for the following primary purposes: 


• To track updates of the Media Database. This infol1mation. is used to· facilitate recovery of 
the Media Database when necessary. 


• To serve as a queue for requests to be performed by the JOA Functional1monitor. 


The Trace file is automatically maintained by CONTROL-T mechanisms that handle the 
Media Database and the requests to the JOA Functional monitol1. 


The length of logical records in, the Trace file may vary, depending on the type of 


infol1mation described in, the recol1d. 


Logical records in· the Trace file are composed of a header (mapped by macro CTTARC) 


followed: by the record data (mapped by the macro relevant for the type of traced action). 


The Trace file is processed as a cyclic· file. RecoJ:1ds aJ:1e written on the oldest logical recond. 


When the physical end~oMile is reached, the next record is written on the first physical record~ 


Fields in the Trace File 


Some ofi the more important fields in the Trace file are listed below. A comprehensive list 
of these fields can be found in, "Logical Field Names for the CONTROL-T Repository" in 


Appendix D, and in the JOA MAC Library. 


ARC LL 


ARCTYPE 


ARCJDENT 


ARCSTAMP 


ARCTI>ATA 


Record Length. 


Record type. 


Name of the component that issued this record. 


Reco:rd time stamp (i.e., when the recoJ:1d was created). 


Actual: information that is recorded. 


Note 
The Trace file can be copied to a sequential variable-blocked file, 
enabling the output to be formatted in a number of different 
ways. (See the description of utility CTTACP in the utility 
section of this manual for: more information.) 


Structure of the Stacking Statistics File 


The Stacking Statistics file contains statistical information about datasets processed by 


CONTROb-T. This infol1mation is gathered from various locations (e.g.,. the Media 
Database, or the Trace file) by utility CTTSTK. The information in this file is used by the 
Dynamic Dataset Stacking facility in the real-time environment. 
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The Stacking Statistics file is composed of the follbwing ph:Y"sical files:. 


• Datafile 


• Index file 


Contains statistical information about datasets that were 
processed by CONTROI;.-T. 


Provides keyed. access to data in the Data file. 


Records in, the Data and Index files are mapped by Assembler macros CTTSTK and 


CTTSTX, respectively. 


Data File Contents 


The Data file contains statistical information about datasets that have been processed by 


CONTROL-T. A dataset is identified by its name and the name of the job which created 
the dataset. 


All record types in the Data file have a common header at the beginning of the record. 
This header contains the following information about the·record: 


RBA 


Record Status Indicator 


Record Type 


Specifies the intemal1record location identifier (explained later). 


Indicates whether the record is active· or free. 


Indicates whether the reco11d is a volume or dataset record. 


Each record in the Data file is assigned an RBA that indicates the location of the record in, 
the Data file. 


Access to· a specific data file reco11d can be perfovmed via its RBA if known1 or via the 
index. Access of a data record via its RBA is known as "non-keyed access." 


Note 
The term RBA as used in this section should not be confused with the term Relative 
Byte Address referred to in IBM literature. The format of the CONTROL-T RBA is 
bbr. The first two· bytes identify the block number in the Data file and the last byte 
identifies the record number in that block. 


Fields in the Data File 


Some of the more important fields in the Data file are listed' below. A compr:ehensive list of 
these fields, can be found in "Logical Field Names for: the CONTROL-T Repository" in 
Appendix D, and in.the IOA MAC Library. 


STKKEY 


STKOBS 


STKPRED 


STKSTAMP 


Index File Contents 


Record key (the dataset name andjob name) .. 


Accumulated number of observations. 


Predicted length of the dataset in feet. 


Record time stamp. 


The Index file contains index records .. These index records enable keyed access of records 
in the Data file. 
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Repository Maintenance 


Verifying Data Integrity of Media Databases 


In the CONTROL-T Media Database, data of different types are stored in separate records 
and are linked via the following mechanisms: 


• Data fields in data records, which reference other data records (e.g., field, D1J>SVOLSR in 
a dataset recovd indicates the record of the volume containing the beginning of the 
dataset). 


• Index records which link data records (e.g~, the L-index record). 


• Counters within data records (e.g., field DVLA:CTD# in a volume record' indicates the 
number of datasets in the volume). 


Media Database integrity is the degree to which the links between data/index records are 
free of errors .. A high level ofi integrity is necessary to ensure smooth processing by 


CONTROL-T. Use utility CTTIDB to check Media Database integrity on a daily basis (e.g., 
as a part of the CONTROL-T New Day Procedure). 


Causes of Media Database Integrity Errors 


As a rule, normal tape processing by CONTROL-T should not cause integrity errors. 
However, such errors can be caused by external events that interrupt CONTROL-T's 


processing, resulting, for example, in partially updated records. Some common causes of 
integrity errors are: 


• 
System~crash. 


• Cancellation of ajob that accesses tapes in the middle of its processing. 


• Interruption, of a CONTROL-T utility that updates records in the Media Database. 


Examples of Errors Due to Interruption of CONTROL-T Processing 


• A volume record points to the next reco:rd in a multi-volume chain1 (via the NEXTVOL field), 
but that volume does not point back (field PREVVOL). 


• A dataset spans a number of volumes different from what is indicated in the record for that 
dataset. 


• An L-index points to.ascratchvolume. 


Integrity errors should not occur often. If utility CTTIDB detects an· unusually large 
number of integrity errors, it is recommended 
1 that you immediately investigate the cause 
of these errors and fix the problem .. 
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Recovering From Integrity Errors 


Some integrity erro11s are automatically resolved by CONTROL-T: 


• L-indexes that point to a scratch volume Ille removed as soon as the scratch volume is 
mounted in response to·a scratch tape request. 


• Some utilities (i.e., CTTRTM and CTTVTM) have restart capabilities which allow them to 
continue from the point at which the utility was interrupted, 


Integrity errovs that are not automatically fixed by CONTROL-T should be handled by 
first studying the nature of the erro11, and then determining what Media Database 
updates should be perfo11med to correct the erro11. 


Analyzing an Integrity Error 


Check the output of utility CTTIDB every day. If an integrity error is detected, you should 
be able to determine the type of error, and which data/index reco11ds are involved, from 


the output of the utility. Below is a list of the most common integrity errors detected via 
utility CTTlDB: 


• Information in a data record and, corresponding information in, an index recovd do not 


match~ 


• A counter field within' a data record has an incorrect value .. 


• A group. of volumes is chained, incorrectly or some volumes in the chain have conflicting 
attributes (e.g., vaulting criteria). 


• Data fields linking datareco11ds point incorrectly. 


• A scratch volume points to, or is pointed to; by an active volume record. 


The method used to· correct the error should be chosen, based on the infovmation found in 
the output of utility CTTIDB and;. optionally, in, the record data viewed via the 
Inquire/Update Media Database Screen (screen Tl). 


Correcting Integrity Errors 


Integrity errors are co11rected by updating the data records and/or index records in error. 
Errors involving data records should be corrected, one at a time, via utility CTTMUP. 


After fixing each error it is recommended to rerun, utility CTTIDB, because fixing one 


errol" often· eliminates other errors. This can be done automatically by specifying 


CHECK=YES in the TYPERUN statement of utility CTTMUP. The output of utility 


CTTIDB after it is rerun will accurately reflect the integrity errors that remain. 


Utility CTTMUP can also be used to fix most index related problems by rebuilding the 
indexes for a volume, a dataset, or a group of volumes and datasets. 


When a large number 0£ index errol"s are found in1 the Media Database, consider fixing 
these errors by rebuilding the index component via utility CTTBIX. 


Note 
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If you choose to rebuild the index of the Media Database, it is necessary to first halt all 
tape processing. 


For a detailed description of utilities CTTIDB, CTTMUP and CTTBIX see Section 9 of 
this guide. 
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Manual Update of the Media Database 


Manual update of the Media Database is accomplished via utility CTTMUP. This utility 
can be used to· add new volume/dataset reco11ds to the Media Database, or to. fix integrity 
errors detected via utility CTTIDB. 


Before using utility CTTMUP, it is impo11tant to familiarize yourself with the structure of 
the Media Database (described, earlier in this section~. Attempting to fix integrity errors 
without p11operly understanding the Media Database structure can lead, to even more 
integrity errors. 


When updating a volume reco11d1 utility CTTMUP does not always automatically update 
the co11responding dataset reco11ds, and vice versa. Wheni updating data fields that are 
used to link reco11ds, be sure to update all relevant records so that no new integrity errors 
are created~ Fo11 example, when you add a dataset to a volume, ve11ify that the new 
number of datasets is recorded in, the volume record. 


When: updating groups of volumes (multi-volume chains), use the group.statements (prefixed 


"GRP") to implement the desired change in the records of all the volumes in: the group. 


After performing the necessary updates, it is highly recommended that you run utility 


CTTIDB to verify the results .. This can be accomplished by running the utility manually, 


011 by including CHECK=YES in the TYPERUN statement of utility CTTMUP. 


See the description of utility CTTMUP in Section 9 of this guide for more information on' 
manual update of the Media Database. 


Enlarging the Media Database 


At times, it may become necessary to increase the size of the Media Database (MDB). This 
situation arises if one of the Media Database components (index 011 data) is almost at 
maximum capacity, OI' if extensive additions to the Media Database need to be made in, the 
near future. 


To enlarge the Media Database: 


1. Calculate the space needed fol' your Media Database. 


To. calculate the amount of space needed> see "Media Database Calculations" in the 


CONTROl!,-T Installation, Considerations and the appendix called "IOA Dataset: Disk 
Sto11age and Security Requirement Table" in, the IOA Installation Guide. The Media 
Database can be enlarged, by increasing the number of blocks, by enla11ging the block size, 


011 via a combination of the two methods. (By following the instructions listed here, any of 


these extension methods are possible.) 


2. Shut downCONTROL-T viathe following operator command: 


S CTTXNXT,PARM='MODE=TERM' 


3, Back up the active Media Database by running CONTROL-T utility CTTDBDUL, IBM's 
utility IEBGENER, or any other similal' tooL 


4. Create and fo11mat new Media Database Data Components by running the same job which 
is run at installation time to allocate Media Database components (see step "CONTROL-T 


Media Database" in the CONTROl!,-T InstallationProceduI'e in1the IOA Installation Guide), 
but with a la11ger allocation size. 
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Note 
Before running this job; verify that at least one of the procedure parameters 
which compose the Media Database component names (DBPREFT, and 
DBFILET) is modified~ By doing so, the active Media Database will not be 
affected. 


5. Unload the Media Database data component via CONTROirT utility CTTilBDBL. 


6. Rename the production Media Database data component and index component. 


7. Rename the newly-created.components. 


Rename the newly-created Media Database data component to the name of the production 
data component. Rename the newly-created Media Database index component to the name 
of the production' index component. 


8. Reload the Media Database data component into the new (and larger) data component via 


CONTROL-T utility CTTDBDLD. 


9. Run utility CTTBIX. 


10.Restart CONTROI:.-T via the follbwing operator command: 
s CTTJ:•NJ:T, PARM= I MODE=:CN:CT I 


Enlarging the Trace File 


At times, it may be necessary to increase the size of the CONTROL-T Trace file .. This 
situation arises if the Trace file often reaches maximum capacity, ov if an increase· in tape 
activity at your site is imminent. 


To, enlarge the Trace file: 


l. Calculate the space needed for the Trace file. 


To calculate the space needed, review the appendix called "IOA Dataset Storage 


Requirements Table" in the IOA Installation Guide. At this stage, you should also 
determine the co11rect value of installation pwameter TRCSIZE in member CTTP ARM in 
the IOA INSTCTT library. The Trace file can be enlarged either by increasing the number 


of blocks, by enlarging the block size, or by a combination of: these methods. By following 
the instructions listed here, any of these extension methods are possible. (For more 
information, on the TRCSIZE parameter see the IOA Installation Guide.) 


2 .. Shut down• CONTROL.-T via the following operator command' 


S CTT:CN:CT,PARM='MODE=TERM' 


3. Back up the active Trace file via CONTROL-T utility CTTACP, IBM utility IEBGENER, or 
any othev similw tool, 


4. Create and format a new Trace file by running the same job used at time of installation· to 
allocate the Trace file, but with a larger allocation size. 


Note 
Before running this job, verify that at least one of the procedure parameters which 
compose the Trace file name (DBPREFT and DBFILET) is modified. By doing so, 
the active Trace file is not affected. 
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5. Update installation parameter TRCSIZE in member CTTPARM of the IOA INSTCTT 
libra:ey acco11ding to the size of the new Trace file. 


6. Run job CTTPARMJ. Running this job (located in· the INSTCTT library) makes the new 
value ofTRCSIZE available. 


7. Rename the production Trace file. 


8. Rename the newly-created Trace file to the former name of the production Trace file .. 


9; Copy the old Trace file to the new (and larger) Trace file via CONTROk-T utility CTTACP. 


An, example of CTTACP activation is provided below: 
//name JOB ,IOA,CLASS=A,MSGCLASS=X 
II* 
II* 
COPY ONE CONTROL-T TRC DATASET TO ANOTHER TRC 


II* 


//TT2ACP EXEC CTTACP, 
11 
TRCIN= 'CTT. V122 .TRC.OLD' I 
II 
TRCOUT='CTT.V122.TRC' 
//SYSIN 
DD* 


COPY FROM=TRACE,TO=TRACE 
II 


10.Resta:vt CONTROL-T via the following operato11 command: 


S CTTINIT, PARM= 'MODE=INIT '· 


Repository Backup and Recovery 


General 


CONTROL-T has a comprehensive set of utilities which ensure data integrity and provide 
full recovery in situations caused by system/disk crashes or user error. The following 
pages describe the p11ocedures that the IOA administrator should perform in various 
situations. 


See Section· 9 in this Guide fo11 a detailed description of the utilities mentioned below. 


Backup and Recovery 


CONTROL-T provides several utilities to facilitate the backup and recovery process. 
Backups can be performed at an:y time using batch utilities. At most sites, backups are 
initiated by the New Day procedure. 


Normally, the Media Database is backed, up first .. It updates the Trace file with the date 
and time that backup started and completed. The Trace file is backed up as soon as the 
Media Database backup completes successfully, Therefore, each Media Database backup 
has a corresponding Trace file backup. AU removable media processing may continue 
during this process. 
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If the Media Database or some po11tion1 o~ it must be recoveredr. 


• Resto11e the latest Media Database backup using the standard site backup utility. Run' 


utility CTTRCV to apply all! updates since that backup fromi the active Trace file (a 


Roll~Fo11Wwd process). 


• Based on the current Media Database, utility CTTRCV can' withdraw all! updates untili a 
certain point (a Roll~Back p11ocess). 


• Utility CTTRCV can also remove all! updates in a specified time range 011 generated by a 
specific job: 


• Once the resto11e is complete, all indexes we rebuilt by utility CTTBIX and the free space 
chain is rebuilt by utility CTTDBID. 


Disaster Recovery 


CONTROL-T recovery is perfo11med using the Trace file from: the last Media Database 
backup via several steps. First, a backup/restore utility (e.g., IEBGENER) is run to 
restore the Media Database. Then, utility CTTRCV is run' to roll fol1Ward all Trace file 
Updates since the last backup; Utilities CTTBIX/CTTilBID are then run to rebuild the file 
structure and indexes. 


Note 
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Before rebuilding the index file, the index format utility (CTTDBF) should be run. 
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Selective Recovery 


This method, recovers onl:v a selection of changes which satisfy specified selection criteria. 


Fo11 example, to recover the actions of a bad maintenance job (e.g., a retention 
management job to which inco11rect parameters were specified) all decisions/actions made 
by this job should be reversed.. Only selected portions ofi the Media Database are 
recovered. This is a logical, backward recovery in two steps via utilities CTTRCV and 


CTTBIX/CTTDBID. 


Note 
After completing the rollback updates, the index formatting utility (CTTDBF) should 
be run, followed by utility CTTBIX which is used to rebuild the index file. 


General Considerations 


Refer to· the following chart to determine when to use each recovery method. 


Comparison of Physical vs. Logical Recovery Methods 


When to use: 
After a physical disaster 
After user errors 


What will be recovered: 
Entire Media Database 


How the data is 


recovered1: 


Via restore and 


roll~forward 


Robotic Library Support 


Selected portions of the· Media 
Database 


Via roll-back 


CONTROL-T supports the various Robotic Tape Library systems available on the market. 
The installation procedure is described below. 


For a general description. of CONTROL-T support for Robotic Tape Library systems, refer 
to "Robotic Tape Lib11ary Support" in Section 4 of the CONTROL-T User Manual. 


Robotic Tape Libraries Using System Managed Tape 
Functions 


The CONTROl!rT interface to robotic tape libraries using Systemi Managed Tape Functions 
(e.g., HDS 7450/7430, and, COMPAREX 6394/6395 robots) is activated in the same way that 
the CONTR01"-T interlace to IBM SMS Managed tape libraries is activated. Therefore, to 
activate the CONTROL-T interface to robotic tape libraries that use System Managed Tape 
functions, perform the steps in "IBM Tape Library Dataservers Support" (below), and then 
continue with the steps in "IBM SMS Managed Tape Library Support" (which follows). 


If you have already activated the CONTROL-T interface to IBM Tape Lib11ary Dataservers 
with SMS managed tape library support, there is no need to· repeat this process. 
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IBM Tape Library Dataserver Support 


To activate the IBM robot interface of CONTRO:G-T, pe11form the following steps: 


A. Specify IBMT as one of the values fo11 pwameter RBTTYPE (via. CONTROL-T step 2:10 in 
ICE). 


B. Save the existing procedu11e CTTRTM under the name CTTRTM2: Rename p11ocedu11e 


CTTRTMB in the procedure lib11aey to CTTRTM. 


The new CTTRTM procedu11e contains a step which activates the interface with the IBM 
robot. 


C .. Save the existing procedure CTTVTM under the name CTTVTM2: Rename procedure 
CTTVTMB in' the Procedure Lib11ary to ·CTTVTM. 
· 


The new CTTVTM p11ocedu11e contains a step which activates the interface with the IBM 
3495 robot. 


CONTROL-T can interface with either IBM SMS Managed. Tape Librwy Support, or IBM 
Basic·Tape Lib11ary Support (BTLS). Continue with the procedure appropriate fo11 your site. 


IBM SMS Managed Tape Library Support 


A. Edit member CTT3495 in: the IOA SAMPLE library. Verify that N is indicated for variable 


BTLS in the follbwing statement: 


B'l'LS 
EQU 
C'N' 
<=== B'l'LS SUPPOR'l' (Y/N) 


B. Edit member ASM3495 in the IOA SAMPLE lib11ary and submit the job: This member 
compiles and links routine CTT3495 into the IOA LOAD lib11ary. CTT3495 contains the code 
necessary for interfacing with the IBM 3495 softwa11e. 


To manage this module using SMP/E, use member IOAEXSMP in the IOA JC:t library 
instead of member ASM3495. (described above). 


User Exits 


The following sample user exits (located in' the IOA SAMPLE library) can1 optionalil.y be 


installed as part 0£ the CONTROL-T to IBM robot interface: 


CBRUXCUA 


CBRUXEJC 
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Change Use Attribute 


Allows a change in the Use attribute of a volume only if this change has 
already been reco11ded in the Media Database. Implementation of this 
exit helps maintain, Media Database integrity. 


The compile and link job for this user exit is in member ASMUXCNA in 
the IOA SAMPLE library. 


Tape Eject 


Turns off the IN TFIE ROBOT status bit in the volume reco11d of the 
ejected volume in the Media Database. 


The compile and link job for this user exit is in member ASMUXEJC in 
the IOA SAMPLE library. 
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Tape Entry 


This exit does the following: 


• Turns on the IN THE ROBOT status bit in the volume record of the 
inserted volume .. 


• Updates the internal location (lib11ary in the robot) in· the volume 
record, 0£ the relevant volume in the Media Database. 


• Sets the INITIAL USE attribute of the volume in' the robot to the 
status in the relevant volume record in the Media Database. 


The compile and link job fo11 this user exit is in member ASMUXENT in 
the IOA SAMPLE lib11ary. 


Volume Not 1n, Library 


Issues a message to the operato11 with the volume location (as recorded 
in the Media Database). On receipt of this message the operator should 
insert the volume into the robot and reply R (retry) to continue. 


The compile and link. job· for this user exit is in member ASMUXVNL in 
the IOA SAMPLE library. 


IBM Basic Tape Library Support (BTLS) 


1. Edit member CTT3495 in the IOA SAMPLE lib11acy and make the following changes: 


• Indicate that BTLS should be supported via the following statement: 


BTLS 
EQU 
C'Y' 
<=== BTLS SUPPORT (Y/N) 


Assign one 0£ the BTLS lib11ary units to the BTLStJNIT parameter in the line which 
follows this line. 


• If you we using 4-digit device numbers (MVS ESA Release 5 and above) change the 
value specified for parameter BTLSII>IGS fromi 3 to 4 via the following statement: 


BTLSDIGS EQU 
4 


Example 


<=== NUM OF DIGITS IN UNIT ADDRESS (3/4) 


If 123 · is the add11ess of one of your robot units, and you are using a release priol' to MVS 


ESA 5, the pa11ameters section: should include the following statements: 


BTLS 
EQU 
C'Y' 


BTLSUN:CT EQU 
C'123' 


BTLSDIGS EQU 
3 


<=== BTLS SUPPORT (Y/N) 
<=== DEFINE ROBOT UNIT ADDRESS 


<=== NUM OF DIGITS IN UNIT ADDRESS (3/4) 


2 .. Edit member ASM3495 in the IOA SAMPLE libracy and submit the job. This member 
compiles and links member CTT3495 into the IOA LOAD library. Member CTT3495 
contains the code necessary for interfacing with the IBM 3495 softwa11e. 


To manage this module using SMP/E, use member IOAEXSMP in the IOA J<DL library 
instead 0£ member ASM3495 (described above). 
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3. Add DD statements BTLSIN and BTLSOUT to step CTTRBM in1 the procedures for utilities 


CTTVTM and CTTRTM. 


• DID statement BTLSIN must point to a temporary file. 


• DID statement BTLSOl!JT must point to aSYSOBT file. 


Example 


If SYSDA is used as a temporary DASD unit, and BTLS messages should be printed to the 
default MSGCLASS SYSOBT class, the above mentioned DID statements should be as 
follows: 


//BTLSXN 
DD 
UNXT=SYSDA,SPACE={'l'RK,l) 


//BTLSOUT 
DD 
SYSOUT=* 


4. Add DID statements BTLSIN and BTLSOBT to your Online environment (i.e., to the user's 
logon procedure) to support options EXPIRE and VAULT in the Inquire/Update Media 
Database screen (Screen, TI). 


StorageTek Silo Support 


To activate the StorageTek Silo interface of CONTROL-T, the following steps should be 
performed: 


Basic Support 


1. Specify STK as one of the values for parameter RBTTYPE in1 member CTTP ARM. 


2. Save this member. 


3. Edit member CTTP ARMJ, in the IOA INSTCTT library and1 submit the job. This job creates 
load, modules CTTP ARM and !OAP ARM in the IOA LOAD library. 


CONTROL-T can interface with either StorageTek's Host Software Component (HSC) or the 


Client Server Component (CSC). Follow the procedure approp?ti.ate for your site .. 


StorageTek Host Software Component (HSC) Support 


1. Edit member CTTRSTK in the IOA SAMPLE library. Verify that 'HSC' is indicated in1 the 
following statement: 


STKTYPE DC CL4'HSC' 


2. Edit member ASMRSTK in the IOA SAMPLE library and submit the job: This member 
compiles and links member CTTRSTK into the IOA LOAD library. CTTRSTK contains the 
specific code for interfacing with the StorageTek Host Software·Component (HSC). 


If you wish to manage this module using SMP/E, refer to member IOAEXSMP in the IOA 
JCL Lib:r~ary. 


3. Save the old procedure CTTRTM under the name CTTRTM2; Rename procedure 


CTTRTMB in the procedure library to CTTRTM. The new CTTRTM contains an additional 
step which interfaces with the StorageTek Silo: 
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4. Save the old procedure CTTVTM under the name CTTVTM2:. Rename procedure 
CTTVTMB in the procedure lib11ary to CTTVTM. The new CTTVTM contains an additional 
step which interfaces with the StorageTek Silo .. 


5;. When using CONTROL-T, the HSC is immediately notified about expired tapes, and their 
status is updated in the HSC's Control, Dataset(s). CONTROL-T uses the HSC API to do 
this .. If the HSC load library (SLS.SLSLINK) is not in the MVS linklist, it should be 
added to DD statement STEPI'..IB 0£ all! environments that may expire a volume. This 
includes: 


• The CTTRBM step in utilities CTTRTM and CTTVTM. 


• The Online Environment. Depending on whether you: operate CONTROL-T Online 


facility under TSO or under the IOA Online monitori, the HSC load library should be 
added to the TSO logon procedu11e STEPI'..IB and/or to the IOA Online monitor 


STEPI:.IB. 


• If you have implemented EDM support (e.g:,. using exit ARCTVEXT for HSM or exit 


TMSCTLEX for DMS/OS), the HSC load library should be added to the HSM, or 


DMS/OS procedure STEPLIB. 


6. User exit SLSUX06 (Volume lnsert.®elete) can be optionally installed' to turn status bit IN 
THE ROBOT on and off, and to update the internal location ofi the volume (the LSM 


address) in, the relevant volume record in the Media Database. 


The sample souvce fo11 this use11 exit is located in member SLSUX06 in: the IOA SAMPLE 


library. 


The compile and link job for this user exit is in member ASMRUX6 in the IOA SAMPLE 
library. 


If you choose to implement user exit SLStJX06, you must first initialize the 
IN TFIE ROBOT status bit and the LSM address .. This is performed via program CTTSLS. 


• The sample source for this program is located in member CTTSLS in the IOA SAMPLE 


library. 


• The compile and link job for this program' is in, member ASMSLS in the IOA SAMPLE 


library. 


• A sample job. which executes this p11ogram is in member CTTSLSJ. in the IOA SAMPLE 


library. 


StorageTek Client System Component (CSC) Support 


1. Edit member CTTRSTK in the IOA SAMPLE libraey. Replace 'HSC' with CSC in the 
following statement: 


STKTYPE DC CL4'HSC' 


2: Edit member ASMRSTK in the IOA SAMPLE library and submit the job. This member 
compiles and links member CTTRSTK into the IOA LOAD library. CTTRSTK contains 
specific code for interfacing with the Sto11ageTek Client System Component (CSC). 


If you: wish to manage this module via SMP/E, refe11 to member IOAEXSMP in the IOA JCL 


library. 
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3. Save the old p11ocedu11e CTTRTM under the name CTTRTM2: Rename procedure 


CTTRTMC in the procedure library to CTTRTM. The new CTTRTM contains an additional 
step which interfaces with the StorageTek Silo: 


4. Allocate a sequential file as a fixed block with arecovd length 0£ 80 bytes. Use the values 
specified for parameters %0LPREFT% and %0LVERT% to name this dataset as follows: 


prefix.version.DASCRCMD 


where 


prefix 


version 


Value specified for pwameter %0f..PREFT% in member DEFP ARMT. 


Value specified for pa:vameter %0LVERT% in1member DEFPARMT. 


This sequential file should be large enough to hold the maximum number of volumes that 
might be expived by CTTRTM in1 one day (one reco11d per volume) .. 


Notes 
StorageTek CSC is not able to perform automatic ejects. After running utility 
CTTVTM, all necessary ejects must be performed manually. 


No application Program Interface (AP!) is supplied with StorageTek CSC. For this 
reason CONTROL-T uses CSC utilitySCUADMIN to notify CSC about expired tapes. 
As a result of this method of operation, note the following: 


• CSC is not notified when volumes are expired manually from the CONTROL-T 


Online environment or when volumes are expired via utility CTTMUP. 


• When an External Data Manager (EDM) is set to scratch volumes immediately, 


CSC is not notified of the scratched tapes. It is therefore recommended that the 
EDM exit (e.g.,. ARCTVEXI' for HSM) scratch volumes in deferred mode. When 
deferred mode is used, EDM volumes are given the status PENDING SCRATCH by 
the EDM exit, and are scratched by· utility CTTRTM the next time it is run, at 
which time CSC is notified: 


CTTTPI Interface to StorageTek Robots 


The initiaH.zation progvam of the Sto11ageTek Host Software Component invokes a 
site-specific media initialization progvam, To indicate that you wish to use utility CTTTPI 


for volume initialization, follow the instructions for the cavtridge initialization' utility in 


Sto11ageTek~s reference m1anual with the following ad 1aptation: 


1. Specify PROG(ctttpiname) toStorageTek~s utility 


where: 


ctttpiname is either CTTTPI of (if: you renamed utility CTTTPI' as described in the final 
adjustments to CONTROh-T installation~ IEHINITT. 


2: Pass the CTTTPI' input control1 statements to StorageTek~s Host Softwwe Component via 
DD statement SLSINIT. 


3. Specify ****** (six asterisks) for CTTTPl pwameter SER. 
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HSC/CSC Scratch Pool Support 


If you are not using scratch pools under CONTROL..-T, specify N for parameter DYNWTO 


in member CTTPARM so that the mount message will not be changed by CONTROL-T. 
(See "Performing Post-Installation Tasks" in the IOA Installation, Guide for more 
information on how to change the value for this parameter.) 


If you intend to use scratch pools under CONTROL-'l', specify M or Y for parameter 


DYNWTO in1 member CTTPARM. CONTROL-Twill modify the mount messages, and the 
scratch pool identification will be added to them. 


To interpret the CONTROL-T mount message, HSC/CSC job processing user exit 


(SLSUX.01) should be used, and the HSC/CSC scratch pool definitions must be 
synchronized, with the pool definitions in CONTROL-T. HSC/CSC scratch pools are 
defined via the SCRPOOL HSC/CSC initialization' statements. 


To implement scratch pooling in your StorageTek Silo, the following procedure should be 
followed,: 


1. Edit member ASMRUXl in the IOA SAMPLE Library and submit the job,. This member 
compiles and links exit SCSUXOl into the HSC LOAD library (SLSL..INK). SCSUXOl 


contains the specific code for interpreting CONTROL-T mount messages. 


If you wish to manage this module using SMP/E, refer to member IOAEXSMP in the IOA 
JCt. library. 


2. Follow these guidelines to keep CONTROL-T pool definitions and HSC scratch pool 
definitions synchronized: 


• Since HSC SCRPOOL statements are less flexible than CONTROL..-T pool' definitions, 
only CONTROL..-T pools that can also be defined to HSC should be defined (e.g., do not 
use wildcard characters in pool definitions). 


• Since HSC supports only 13 characters as a valid, scratch pool name, use pool names of 
13 characters or less in CONTROL-T. 


• HSC does not enable dynamic (i.e., during operation) changes to SCRPOOL statements. 
Therefore, when dynamically changing CONTROL..-T pools, care should be taken to not 
interfere with HSC processing; 


ExLM Support 


If you are not using Expert Library Manager (ExLM) software from StorageTek, ignore 
this topic. 


The interface between' CONTROL-T and ExLM is performed by utilizing the "CUSTOM 


Tape Management System Support" for release 1.2.0 of ExLM. To activate the interface 
you need release 1.2~0 of ExLM with PTF LlLOOlU or L1L002C (or any other PTF 


supplied by StorageTek technical support). If you do not have the above release or PTF 


level of ExLM, contact your StorageTek representative. 


To access the CONTROL-T Media Database from ExLM, the following procedure should be 
followed: 


• Define CONTROL..-T as the TMS used in the ExLM control statements, as follows: 


TMS CUSTOM NAME(CONTROLT) DDNAME{DAMDB) MODNAME{CTTXLM); 
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• Add the IOA LOAD library to DD statement STEPLIB of the ExLM JCL. This is not 
requil'edifyouhave added the IOA LOAD library to the MVS Linklist. 


• Add a DD statement fo11 the Media Database data component to the ExLM JCL, as follows: 


/ /DAMDB DD DSN=ctt. vS00 1.MDBD, D:CSP=SHR 


Note 
The name of the Media Database data component should be adjusted to the prefix 
and version of the CONTROb-T Repository· used at your site. 


Samples for the ExLM JCL and ExLM control' statements can be found in members 


EXLMJOB and EXLMSAMP in the IOA SAMPLE library. 


MEMOREX TELEX Automatic Tape Library (ATL) Support 


To activate the MEMOREX TELEX Automatic Tape Library (ATI:,) interface of 


CONTROL-T, perform, the following steps: 


1. Specify MEMOREX as one of the values fov parameter RBTTYPE inmember CTTPARM. 


2:. Save member CTTPARM. 


3: Edit member CTTP ARMJ. in, the IOA INSTCTT library and submit the job. This job creates 
load modules CTTP ARM and IOAP ARM in1 the IOA LOAD libvary. All steps of this job must 
end with a condition code of 0. 


4. Edit member ASMMMRX in the IOA SAMPI:,E lib:vary and submit the job. This member 
compiles and, links member CTTMMRX fromi the IOA SAMPI:,E library into the IOA LOAD 
libvary. Member CTTMMRX contains the code necessary fo11 interfacing with the 
MEMOREX TELEX ATI:, softwwe (LMS) during immediate SCRATCH/EJECT operations 
(in the Online environment). The robot database is synchronized with the Media Database 
via a batch, procedure which is supplied by MEMOREX. (Refer to the MEMOREX TELEX 
documentation fo:v more information,) 


To, manage this module using SMP/E, use routine IOAEXSMP in the IOA JCL libral'y 


instead of member ASMMMRX (described. above). 


EMASS Automatic Tape Library (ATL) Support 


To activate the EMASS Automatic Tape Lib:vary (ATL) interface of CONTROL-T, perform 
the following steps: 


Note 
The method used to activate EMASS tape library· support can also be used for 
interfacing with GRAU and Bosch tape libraries. 


A. Specify EMASS as one of the values fo:v pa:vameter RBTTYPE in 1 member CTTP ARM. 


B. Save member CTTPARM. 


C. Edit member CTTP ARMJ. in' the IOA INSTCTT libraey and submit the job; This job creates 
loadmodules CTTPARMandIOAPARMinthe IOALOAD library. 
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D. Edit member ASMHACC in the IOA SAMPLE library and submit the job .. This member 
compiles and links member CTTHACC from the IOA SAMPLE library into the IOA LOAD 


library. Member CTTHACC contains the code· required fo:ri interfacing with the EMASS 


ATL 
software 
(HCC) 
during 
vault 
management 
ope:riations 
and 
immediate 


SCRATCH/EJECT operations (in the On-Line environment). The robot database is 
synchronized with the Media Database via a batch, pI"ocedul"e which is supplied by EMASS. 


(For mol"e infol"mation, refer to·the EMASS documentation.) 


To manage this module using SMP/E, use routine IOAEXSMP in the IOA JCL library 
instead of member ASMHACC (described above). 


E. Save the old CTTVTM procedure under the name CTTVTM2. Rename procedure 
CTTVTMB in the procedure library to. CTTVTM. The new CTTVTM contains an additional 
step which interfaces with the EMASS robot. 


Depending on the ABBASEND interface (which is used by the CONTROL-T interface) 


requi:riements, you may need to add1the follbwing DD statement to the CTTRBM step:. 


HACCOUll' 
DD 
SYSOU'll'=* 


Cartridge Message Display Customization 


The CONTROb-T interface for displaying messages on cartridge magnetic tape 
subsystems allows you to: 


• Display the fil"st seven characters of a pool name on, the cartridge drive LCD display when a 
scratch tape is requested from a specific scratch pooh 


• Stop automatic cartridge load when two consecutive tape mounts result in the rejection of 
the mounted tapes .. To enable this feature, the Cartridge Stack Loader (CSL) must be set to 


SYSTEM mode. 


Message display installation exit IGXMSGEX is p:riovided as a module that you' can use to 
customize messages to be displayed on an IBM 3480 tape drive. This exit is optional, and 
is invoked only if it is link-edited with the message display execution module (IGC00030). 


Installing the Message Display Interface 


Installation· of the message display interface is perfo:rimed via the application of an SMP/E 
USERMOD to your MVS SMP/E environment. This USERMOB introduces two 


CONTROL-T CSECTs (IGXMSGEX, and CTTMSGD) which: are linked to module 


IGC00030 in the LPA library. 


Note 
If you already have another Message Display interface installed, make sure that it is 
removed before installing the CONTROL-T interface .. 


The steps described below are applied to your MVS SYSl.LPALIB library. You can 
apply these changes to your MLPA library instead, by overriding the LPALIB DD 
statement (either through DDDEF, or through your MVS SMP IE JCL procedure). 
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To install the CONTROL-T interface to the Message Display, perform the following steps: 


1. Edit member IGXMSGEX in, the IOA SAMPI:.E library. Member IGXMSGEX contains a 
sample message display installation exit which allows control1 to· be passed to. several 
modules for customization ofi MVS messages before they are displayed on, an IBM 3480 tape 
drive. Alli modules to be passed control are listed: under label, MOIDLIST in' this sample 
member. By default, this list contains only one module (CTTMSGD), which is the 


CONTROl.-T message customization 
1 module. 


You can, let other modules process tape drive messages in parallel' to the CONTROL-T 


interface (e.g., foll parallel pllocessing by CA-1) by adding an entry fo11 each of these modules 


undell label, MOIDLIST in sample member IGXMSGEX. (See comments in this sample 
member foll the valid foI1IDat of module specifications.) 


It is recommended that you save a backup copy ofi sample member IGXMSGEX before 


modifying it. AU changes to this sample member must be saved befolle proceeding to· the 
next step (Step.2). 


2: Use SMP/E online panels to find the Owning FMID ofi "MOD IGX00030" and write it down 
for later reference (Step 4a below). 


3~ Save a backup copy ofimodule IGC00030'before continuing with the next step; This module 
is located; in you11 LPA libllary. 


4. Edit member INSTMSGD in the IOA INSTCTT library. This member contains ajob that 
uses SMP/E to· compile member lGXMSGEX and, link,..edit it with module IGC00030: 


Tailt)l'I the job· as follows: 


A. Replace the FMID withthe FMID obtainedin:Step.2; 


B. Replace the SMP JCL procedulle name with your installation's MVS SMP/E JCL 


procedure. 


C. Update the target zone name to·reflect your MVS target environment name. 


D. Add the IOA SMPPTS and IOA MAC libraries to your procedulle's SYSLIB specification. 


Submit the job; 


The job should complete with a return code of 0. 


To activate the CONTROL-T message display interface, either IPL your system, or use a 


systemtool(e.g., RESOI:,VE) to dynamically add the new IGC00030 module to your MLPA. 


Note 
If you have already implemented the CONTROL-T Message Display· Interface 
(described above) and you wish to update member IGXMSGEX, repeat only Step 4 
(above) using job REDOMSGD instead ofjob.INSTMSGD. 
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External Data Manager Support 


CONTROL-T supports various External Data Managers, such as HSM and1 DMS/OS and 


CA-ASM2~ The installation procedures are described below. 


For a general description of CONTROL-T suppo11t for External Data Managers (EDM), 
refer to External Data Manager Volumes in Section' 4 o£the CONTROL-T User Manual. 


Note 
Verify that there is an active CONTROb-T environment (established via CTTINIT) on 
each CPU in which an External Data Manager (EDM) is being invoked. If no 


CONTROb-T environment exists, the EDM interface fails to, update the CONTROL-T 


Media Database and a synchronization problem between CONTROL-T and the EDM 
is created~ 


HSMSupport 


To activate the HSM interface of CONTROL-T, perform the following steps: 


1. Edit member ASMTVEXT in the IOA SAMPI'.,E library. This member compiles and links the 


HSM Tape Volume exit, ARCTVEXT. ARCTVEXT is called by HSM whenever a tape 
volume no· fonger contains valid data. The exit maxks the volume as scratch in the Media 
Database and, optionally, interfaces with a Robotic Tape Lib11ary at the site. 


If you are cunently not using exit ARCTVEXT, submit the job, If you are using this exit, 
member ARCTVEXT contains instructions for integrating you11 cunent ARCTVEXT exit 
with CONTROL-T's exit in Global Test and Global· Phased modes. You should stop using 
your other p11oduct's ARCTVEXT exit when you move CONTROI'.,-T to Global Production' 
mode. 


2~ Verify that the IOA LOAD lib11ary is defined: as one o£the STEPLIB 011 LINKLIST lib11aries. 


3. Verify that you have created rules that identify- 
datasets created by HSM as 
EDM-controlled (DO RETENTlON=EDM). The job name, dataset name, p11ogram1 name, or 
volser can' be used as selection· criteria. You may want to exclude the CDS backups made by 


HSM from HSM controL This can be done by defining special: rules fo11 these datasets. 


Note 
ADSM (ADSTAR Distributed Storage Manager) invokes deletion exit ARCTVEXT 


when it releases a tape. This exit, which is invoked in the ADSM address space, is 
identical to the ARCTVEXT exit used by HSM. 


DMS/OS Support 


To activate the DMS/OS interface of CONTROL-T, perform the following steps: 


1. Edit member ASMCTLEX in: the IOA Sample library and submit the job .. This member 
compiles and links the DMS Tape Volume exit, TMSCTLEX. Exit TMSCTLEX is called by 


DMS whenever a tape volume no longer contains any valid data. The exit ma11ks the volume 
as scratch in the Media Database and~ optionally, interfaces with the Robotic Tape Library 
at the site. 
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If you1 are currently not using exit TMSCTLEX, submit the job: If you are using this exit, 
member TMSCTLEX contains instructions for integrating your current TMSCTLEX exit 
with CONTROL-T's exit in Global: Test and Glbbal Phased modes .. Stop using you11 other 


p11oduct's TMSCTLEX exit wheniyoumove CONTROL.-T to·Global1Production mode. 


2:. Verify that the IOA LOAD lib11ary is defined, as one of the STEPLIB011 LINK.LIST libraries. 


3. Make sure CONTROL-T contains rules that identify datasets created, by DMS as 
EDM-controlled(using parameter DO RETENTION=EDM). The job name, dataset name or 
program name can be used as selection criteria• 


CA-ASM2 Support 


CONTROL.-T and CA-ASM2 interface via CA-ASM2 exit $FTEXIT (the Free Tape Exit). 


CA-ASM2 passes control to this exit before freeing a tape . .In the sample fo11 this exit supplied 
with CONTROL-T (membe11 AS2FTEXT in the IOA SAMPLE library), the CONTROI!,-T 


expiration' utility (CTTEXP) is called to expille the volume being freed (Le.,. to mark it 


SCRATCH in the CONTROI;,-T Media Database). 


To activate the CA-ASM2interface o£CONTR01.-T, perform the follbwing steps: 


l. Define alli CA-ASM2'tapes as members in tape pools of CONTROl!.-T. 


Definition of tape pools is not related to the value 0£ CA-ASM2 installation paramete11 
$TAPPOOb. Tape pools must be defined fo11 CA-ASM2 tapes regardless of whether 011 not 


CA-ASM2 tape pools are enabled. Pool definitions under CONTROL-T ensure that only 


CA-ASM2SCRATCH tapes are used by CA-ASM2jobs .. 


2. If paramete11 $TAPPOOL is equal1 to X'Ol' (i.e., CA-ASM2 tape pools are enabled), skip to 


Step 3 (below). Otherwise, define rules that instruct CONTROL.-T to use only tapes from 
these pools for datasets created by CA-ASM2: 


The dataset names in the rules you define must be identical1 to· those which appear in 


MOBNT messages for the relevant volumes. If you changed the Dummy dataset name 
(written as the :fuist file on each CA-ASM2 tape), use the new name in the rules also. 


3. Edit member AS2FTEXT in the IOA SAMPLE lib11ary. This member contains the $FTEXIT 
supplied with CONTROl;,-T, and it includes complete instructions on how to edit the 
member. 


Note 
When the CONTROL-T copy of $FTEXIT finishes processing, it can optionallygive 
control to another copy of $FTEXIT. This can be useful when working with 


CONTROL-T in PHASED or TEST mode in parallel with another tape 
management product. 


4. Edit member ASMFTEXT in the IOA SAMPLE library. This job compiles and links exit 
$FTEXIT. Submit the job. 


5:. No updates to the CONTROL-T Media Database are requilled from CA-ASM2'exit $NTEXIT 
(New Tape). 


If you choose to compile the original copy 0£ exit $NTEXIT supplied with CA-ASM2, and 


CONTROL-Tis the only tape management p11oduct installed, verify that NONE is specified 
for pa11ameter &TAPEMGT before this exit is compiled: 


6~ Verify that the IOA LOAD lib11ary is defined as one of the STEPLIB or LINK.LIST libraries. 
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DF/SMS Support 


The CONTROL-T to DF/SMS Interface enables you to: 


• Determine the expiration date of a dataset on the tape according to DF/SMS Management 


Class definitions. 


• Use Management Class as a selection parameter in rule definitions (see ON MGMTCLAS in 


Section 3 of the CONTROL-T User Manual). See "CONTROL-T to DF/SMS Interface" in 


Section 4 of the CONTROI:.-T User Manual for information regarding the use of this 
interface. 


To activate the DF/SMS interface of CONTROL-T, performithe following steps: 


1. Edit member CTTP ARM in' the IOA INSTCTT libr:ary: 


• Specify Y for parameter SMSINTR. 


• Review the description of the OVERJCL installation parameter, and deter:mine if its 
value should be changed~ 


• Save this member. 


2~ Edit member CTTPARMJ, in1 the IOA INSTCTT library, and submit the job; This job creates 
load modules CTTPARM and IOAPARM in the IOA LOAD library. AU: steps in this job must 
end with a conditioni code of 0: 


3. If CONTROI;,..T is active, refresh the installation parameters in memory. To do this, issue 
operator command S CTTINIT,PARM='MO)J)E=LOAD,TBLT=PARM'. 


4. Define special 
1 Storage Classes and Management Classes for tape datasets. Few of the 
Management Class attributes are relevant for CONTROL-T and Storage Class attributes 
are not at all relevant for CONTROL-T. It is necessary to define special Storage Classes 


because DF/SMS activates the Management Class ACS routine only if a Storage Class is 
assigned to the dataset. 


5. Adjust Installation ACS routines to support the new values for parameter &ACSENVIR set 
by CONTROL-T. (See "Automatic Class Selection" in Section' 4 of the CONTRO:t-T User 


Manual for more information.) 


See "Adjusting ACS Routines" below for some examples of DF/SMS ACS routines adjusted 
for CONTROL-T activation. 


6. Translate and validate the newly adjusted ACS routines (via ISMF). 


7. Validate the modified SCDS (via ISMF). 


8. If validations in Steps 6 and 7 were performed successfully, activate the new SCDS. 


Note· 
At this stage, the CONTROL-T to·DFISMS interface is active. If the DFISMS AGJS 


routines assign a Management Class for a newly created dataset, the Management 
Class is recorded in the CONTROL-T MediaDatabase and used lYy utility CTTRTM. 


9. Optionally, you can define rules that use Management Class as a selection criterion (i.e., 


ON MGMTCI:.AS). If you define such rules, you must refresh the CONTROL-T rules in 
memory. To. do this, issue the following operator commandt 


S CTTINIT,PARM='MODE=RELOAD1TBLT=RULE' 
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Adjusting ACS Routines 


Below are sample adjustments to ACS routines that allow for support 0£ new values 
(supplied by CONTROL-T) fo11 parameter &ACSENVIR. 


Example I 


In this example, Management Class SHORTERM is assigned to all tape datasets that end 
with .TEMP. 


Note that the same Storage Class (CTTSC) is assigned to all tape datasets. It is assigned 
only to enable DF/SMS to invoke a Management Class ACS routine. 


Storage Class Adjustments 


/*******************************/ 
/* DEFINE TAPE UNIT NAMES 
*/ 
/*******************************/ 


FILTLIST TAPES INCLUDE(TAPE* ,CAB.T* ,T3420* ,T3480*, I 3420 I, I 3480 I). 


/******************************************/ 


I* SET A STORAGE CLASS FOR TAPE DATASETS 
*/ 
/******************************************/ 


WHEN (&ACSENVIR='CTTOPEN' && 
&UNIT=&TAPES) 


SET &STORCLAS = 'CTTSC' 


Management Class Adjustments 


/*******************************************************/ 
/* SET A MANAGEMENT CLASS FOR TAPE 
'*.TEMP' DATASETS 
*/ 
/*******************************************************/ 


WHEN (&ACSENVIR='CTTOPEN' && 
&LLQ='TEMP') 


SET &:MGMTCLAS = 'SHORTERM' 


Example 2 


Im this example, tape dataset DSN. WEEKLY is assigned to pool1 WEEKBKP, and Management 


Class KEEFMNTH is assigned to this dataset in1the CONTROl!..-T Media Database (MDB). 


Note that the same Storage· Class ( CTTSC) is assigned to aU tape datasets. It is assigned only 


to enable DF/SMS invoke a Management Class ACS routine. 


A different Management Class is assignedfo11 eachivalue of parameter &ACSENVIR. 


During mount processing for dataset DSN.WEEKLY, Management Class WEEK is assigned to 
this dataset. Rule 1 assigns pool WEEKBKP to this Management Class. 


During open processing for this dataset, Management Class KEEPMNTH is assigned to this 
dataset and this information is recorded in the Media Database. Rule 2 causes the volume of 
this dataset to be vaulted in, vault SAFE fo11 l0 days. 
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Storage Class Adjustments 


/*******************************/ 


I* DEFJ:NE TAPE UNJ:T NAMES 
*I 


/*******************************/ 


FJ:L'l'LJ:ST TAPES J:NCLUDE(TAPE* ,T3420* ,T3480*, I 3420'', I 3480 I} 


/******************************************/ 


I* SET A STORAGE CLASS FOR TAPE DATASETS 
*/ 


/******************************************/ 


WHEN (&ACSENVJ:R='CTTOPEN' &:&: UNJ:T=&:TAPES) 


SET &:STORCLAS = 'CTTSC' 


WHEN ( &ACSENVJ:R= I CTTMNTV I 
&:&: Ul'l:IT=&:TAPES} 


SET &:STORCLAS = 'CTTSC' 


Management Class Adjustments 


/***********************************************************/ 


I* SET A MANAGEMENT CLASS FOR TAPE 
'DSN.WEEKLY' DATASETS 
*/ 
/***********************************************************/ 
WHEN (&ACSENVJ:R='CTTOPEN' &:&: 
&:DSN='DSN.WEEKLY'} 
SET &:MGMTCLAS = 'KEEPMNTH' 


WHEN (&ACSENVJ:R='CTTMNTV' &:&: 
&:DSN='DSN.WEEKLY'} 
SET &:MGMTCLAS = 'WEEK' 


CONTROL-T Rule 1 


ON MGMTCLAS 
= WEEK 


ON DATASET 
= * 
======================== 
DO POOL 
= WEEKBKP· 


CONTROL-T Rule 2 


And/Or/Not A 


ONMGMTCLAS 
= KEEPMNTHAnd/Or/Not A 


ON DATASET 
= * 
======================= 
DO VAULT 
= SAFE 
UNTJ:LDAYS0010 


Dynamic Dataset Stacking Facility 


The Dynamic Dataset Stacking facility is a unique CONTROL-T feature that is 
significantly different from conventional and batch dataset stacking. 


If you intend to implement dataset stacking, read this description of the Dynamic Dataset 
Stacking facility even if you are already familiar with conventional and batch dataset 
stacking. The information pvovided in' this text wiU help you activate and test 


CONTROL-T's Dynamic· Dataset Stacking facility. 


For a general description of the Dynamic Dataset Stacking facility, refer to "Stacking" in 


Section 4 of'. the CONTROL-T User Manual. The following discussion assumes an 
understanding of CONTROL-T's stacking algorithms and operation. 
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General Considerations 


Before activating the Dynamic Dataset Stacking facility, verify that the parameters that 
relate to the Dynamic Dataset Stacking facility are set during installation• 


In general, the CONTROL-T Dynamic Dataset Stacking facility selects a volume fo11 


stacking only if the following conditions ave met: 


• Parameter DYNSTK=Y is specified in 
1 member CTTPARM and a DO STACK=Y statement 
is specified in, a matching rule. 


• The job name and dataset name of the creatingjob and created dataset match the job name 


and1 dataset name that appear in the stacking statistics file. If you want to change this 
criteria (e.g., consider alli datasets with a specific prefix as the same dataset for stacking 


pUJ:1Poses), youcan 1use the Dynamic Dataset Stacking facility user exit CTTX002to override 
the default operation of CONTROL-T. 


• The average length in1 feet of the specified dataset is read from the appropriate entry in the 
Stacking Statistics file. If this information, cannot be found,. stacking cannot continue. To 
avoid this problem, specify a default length for datasets via parameter STKDEFFT in 
member CTTP ARM. 


• An appropciate volume is found in the Media Database. This volume must be eligible for 
stacking, have sufficient free space, and belong to the same pool1 as the dataset to be 
stacked. Depending on the specification, for CONTROL-T parameter DYNSTYP, the volume 
used for stacking may also. need to have the same vaulting pattern as the dataset to· be 
stacked. 


The search for a suitable volume can be controlled by Exit 10 (Find Stackable Volume) 
which' controls the stacking algo:vithm, For more information. about Exit 10, refer to member 


DOCTXOlO in the IOA SECUDATA library. 


The search can be limited to· a specific number of volumes via parameter STKSRCNL in 
member CTTPARM. 


Note 
The above list is not a complete list of conditions,. considerations and parameters. 
See "Stacking" in Section 4 of the CONTROb-T User Manual. 


Non-scratch' volumes conlV'erted to CONTROL-T from another Tape Management System 


are considered, not eligible for stacking. Stacking is only performed fol'I volumes that were 
moved from scratch status to non~scratch status (i.e., the first dataset was created on the 
scratch volume) while CONTROL-Twas operational. 


Activating the Dynamic Dataset Stacking Facility 


Before activating the Dynamic Dataset Stacking facility, set and create all the required 
definitions in accordance with the specifications outlined in' "Stacking" in Section 4 of the 


CONTROL-T User Manual. 


To activate the Dynamic Dataset Stacking facility, the Stacking Statistics file must 
contain stacking information for created datasets .. This file was created during the 
conversion process from your previous Tape Management System and is updated on a 
daily basis as pa11t of the CONTROL-T New Day procedure .. 
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Activating the Dynamic Dataset Stacking Facility in Global 
Test Mode 


When CONTROL-T operates in Global Test mode, the Dynamic Dataset Stacking facility 
is not activated (since CONTROL-T does not intervene with the environment). However, it 
is sometimes desired to check the Dynamic Dataset Stacking facility befo11e moving 


CONTROL-T to Global Production mode. 


To activate the Dynamic Dataset Stacking facility while CONTROL-T is operating in 
Global Test mode, specify Y (Yes) fo11 pavameter STKTEST in member CTTPARM. 


Testing the Dynamic Dataset Stacking Facility 


For ease 0£ testing, these instructions assume that your Stacking Statistics file does not 
contain sufficient information, but you would like to test the Dynamic Dataset Stacking 
facility anyway. 


Testing a single jobwith a single dataset is usually the first step in activating the 
Dynamic Dataset Stacking facility. This can be accomplished by following the guidelines 
for one of the options listed below: 


Option 1 
Testing the Stacking Facility Without Updating Information in the 
Stacking Statistics File 
U 
A. Specify S for parameter DYNSTYP in, the member CTTP ARM. 


u 


Ensure that a value other than 0 is specified for parameter STKDEFFT in 
member CTTP ARM. 


B. Ensure that a number of volumes contain1 sufficient free space (but are not 
empty). These must be volumes that were "created" (i.e., their status was 
changed from SCRATCH toACTIVE) while CONTROL-Twas operational. 


C. Cveate a dataset that matches the selection criteria (ON statements) in a rule 
containing the statement DOSTACK=Y. 


Option 2 
Testing the Stacking Facility With Updating Information in the Stacking 
Statistic File 


A. Create test datasets fol' stacking using a specific dataset name and job name. 


Perfol'm this step while CONTROL-Tis active so that information about these 
datasets will be stored in the CONTROL-T Trace file. 


B .. Run the CONTROI:.-T stacking Statistic utility (CTTSTK) with parameter 
TYPERUN MODE=TRC. The utility will collect dataset information from the 
Trace file and update the Stacking Statistics file. Refer to Section 6 of the 


CONTROL-T User Manual for additional information' about utility CTTSTK. 


C. The Dynamic Dataset Stacking facility is only- activated for datasets that are to 
be cataloged' .. Leaving them cataloged prevents cataloging new datasets with 
the same name. 
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D. Make suve that you have a number of volumes with sufficient free space on 
them (but not empty). These must be volumes that were "created" (i.e., their 
status changed from scratch to active) while CONTROL-T was operational' 


These volumes may be required, according to CONTROL-T parameters, to 
belong to the same pool and have the same vaulting pattern as the test 
datasets. 


E. Recreate another version1 of the datasets created in step A using the same 
dataset name and 
1 job name .. The datasets must be cataloged fo:ri the Dynamic 
Dataset Stacking facility. 


Activating the Dynamic Dataset Stacking Facility for the 


Entire System 


To activate the Dynamic Dataset Stacking facility fo:ri the entire system~ set the 
parameters described above and in "Stacking" in Section 4 of the CONTROL-T User 


Manual. After activating and testing the Dynamic Dataset Stacking facility in Global Test 
mode, activating it in Global Production mode should not p:riesent any problem. 


One point to consider is the specification, of similar dataset names and job names as 
stackable. By default, CONTROL-T keeps statistics by specific dataset names and job 
names. As a result, a dataset is considered eligible fo:ri stacking only if it is created with 
the same dataset name and by the same job name, with the exception of Generation Data 
Groups (GDGs) that are treated as the same dataset name. 


If you need to stack datasets whose names may vary (e.g,, they contain the creation date 
as part of the dataset name) or that alle created by a different job each time, you can1 
implement user exit CTTX002 that overrides the Dynamic Dataset Stacking facility 
default operations. 


For additiona1'information 
1 on' user exit CTTX002; refer to member DOC::TX002 in the IOA 
SECUDATA library. 


The following aspects of the search p11ocedure should be conside11ed when setting values 
for the parameters used by the Dynamic Dataset Stacking facility: 


• CONTROL-T searches fo11 a stackable volume for each tape dataset in1 the JCL. Datasets to 
be stacked must conform to the criteria described, in, Section 4 of the CONTROL-T User 
ManuaL The datasets are then stacked acco:riding to the information in matching rules. 


• The search pllocess can be limited to· a specific number of volumes via parameter 


STKSRCNL, so that only the specified numbell of volumes are scanned to find a suitable 
volume for stacking, 


• The sea11ch process has function1 calls to user exit CTTXOlO (Find Stackable Volume) which 
can, be used: to change search, algo:riithm decisions (i~e., to Accept a volume, Reject a volume, 


ov Supply a new volume to be used fo11 stacking). For further information 
1 about Exit 10, 


refer to member DOCTXOlO in the IOA SECVDATA libracy. 
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CONTROL-R Support to CONTROL-T 


CTRXOOl (CONTROL-R exit 1) must be defined as an interface between CONTROL-Rand 
CONTROL-T. This exit must be defined in addition to (not as a replacement for) any 
previously defined CONTROL-R exit 1 (e.g., an interface between CONTROL-R and 
another product such as HSM or CA-1). 


The CONTROL-R Driver exit (described below) is used to invoke the CONTROL-T 


interface exit 1 and any previously defined exit l(s). 


Exit 1 used for the CONTROL-T interface receives dataset DELETE requests and changes 
the CONTROL-T controlled dataset status to Pending-Scratch, This enables expiration of 
the specified dataset by the next run of Retention Management utility CTTRTM. Via 
customization of this exit, you can cause CONTROL-T controlled datasets to be scratched 
immediately (i.e.,. without running utility CTTRTM). 


CONTROL .. R Driver Exit CTRXOOlG 


The CONTROL-R Driver exit invokes multiple user exits optionally used to provide 
programming interfaces to various dataset management software packages (e.g., HSM or 


CONTROL-T). The CONTROL-R Driver exit sequentially invokes all user exits listed' in 
its source text (see step 4 below). Any number of single purpose CONTROL-R user exits 
may be listed. 


Installing the CONTROL .. R Interface 


Perform the following steps to install the CONTROL-R to CONTROL-T interface. 


1. Verify that YES is specified for CONTROL-R installation parameter TAPEMS in member 


CTRPARM. 


2. Compile and link the existing CONTROL-R exit 1 via member ASMEXIT in the 


CONTROL-T JCL. library. Include the following linkage-editor statements in1 the JCL to 


verify that the load module created by the link-edit step is placed in, the IOA LOAD library 
and assigned' the name CTRXOOlA: 


ENTRY 


NAME 


CTRXOOl 


CTRXOOlA(R) 


3. Use member ASMEXIT to compile and link the sample exit used to implement the 


CONTROL-T to CONTROL-R interface. Member ASMEXIT is located in the CONTROIL.-T 


JCL library. The sample exit is located in member CTRXOOlZ in the IOA SECUDATA 


library. 


Include the following linkage-editor statements in the JCL to verify that the load module 
created by the link-edit step is placed in the IOA LOAD library and assigned, the name 
CTRXCTT: 


ENTRY 


NAME 


CTRXOOl 


CTRXCTT(R) 
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4. Compile and link Driver exit CTRXOOlG via member ASMEXIT in the CONTROL-T JCL 


library. Include the following linkage-editor statements in the JCL to ensure that the load 
module created by the link-edit step. is placed in the IO.A LOAD library and assigned the 
name CTRXOOl: 


CHANGE 
CTRX001(CTRX001A) 


INCLUDE 
SYSLIB(CTRXOOlA) 


CHANGE 
CTRXOOl(CTRXCTT) 


INCLUDE 
SYSLIB(CTRXOOlZ) 


ENTRY 
CTRXOOl 


NAME 
CTRXOOl(R) 


The following exit names are providedwiththe CTRXOOlG sample Driver exit: 


CTRXCTT 
Name of the CONTROL-T to CONTROL-R interface exit 1. 


CTRXOOlA 
Name of anadditionalCONTROI:.-R exit 1 thatmight be inuse at 
the site. 


See member CTRXOOlG in the IO.A SECUDATA library for more information on the logic 
implemented by this exit. 


CONTROL-T Application Programming Interface 


The CONTROL-T Application Programming Interface provides an interface between 


CONTROL-T and user application programs. CONTROL-T API requests are perfollmed 


using Assembler macros. All macros mentioned in this section', including mapping macros, 
are located in the IO.A MAC libllary. 


Calling p11ograms can interface with CONTROL-T via either a Base Level ov a High Level 
APL The differences between these types of AP!' are discussed later in, this section. 


Note 
Examples of macro code usage and JCL are provided later in this section. 


This section contains the following infovmation: 


Background Information 


• CONTRO!'...-T Control Table (TCT) 


• Media Database structure and access 


• Base Level vs. High Level AP! 


Base Level APl 


• Record access by the Base Level AP!' 


• Macro· CTTIOS 


• Base Level APl access of the Media Database 


7-44 
IOA Rel. 5.0.0Administrator Guide 


u 


u 


/ 
·. 
\_) 


u 


u 


Section 7: Customizing and Administering CONTROL-T 


• Examples of macro access and Base Level API functions 


High Level API 


• Macro CTTACC:DB 


• Macro,CTTCHKDB 


• Media Database Handling Routines 


• Example ofmacro·usage andJQI:, for High.Level AP! 


Background Information 


Users should become familiar with the following background infollmation before using the 


CONTROL-T Application Programming Interface .. 


CONTROL-T Control Table (TCT) 


CONTROL-T utilizes a control 
1 table across all environments under which CONTROL-T 


operates. This table, called the CONTROL-T Control, Table (TCT), is mapped by macro 
CTTTCT. 


The TCT contains, among other values, the various parameters specified in member 


CTTPARM during installation1• The CONTROL-TAP! uses various indicatoJ'.ls from the 


TCT in its decision~making pllocess. 


Note 
The TCT, and all other major CONTROL-T blocks, are allocated above the 16MBline. 
Therefore, all programs using the CONTROL-TAP! must run in extended addressing 
mode (AMODE 31). 


The TCT is not a load module and therefore cannot be loaded using the LOAD macro .. To 
load the TCT, use routine CTTTl.D. 


Sample instructions for loading the TCT are pllovided· in the examples included in this 
section. 


Media Database Structure 


The AP! consists of Assembler macros that facilitate interaction with the CONTROL-T 


Media Database. Therefo11e, familiallity with the Media Database format is a prerequisite 
to using the APT. For a detailed description of the Media Database see "Media Database 


Structure" earlier in this section. 
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Base Level vs. High Level API 


A calling pvogram can interface with CONTROL-T via either the Base Level or High Level 


APl (Application Programming Interface). The Base Level! APl offers versatility with few 
fixed requirements. The High Level API' pvovides move automation but requires an active 


CONTROL-T Real-Time Environment and APF authorization. Below is a table which 
details the diffe11ences between these two types of APl access methods. 


Note 
The term "Real-Time Environment" as used in this section refers to the CONTROL-T 


environment initialized by operator command: S CTTINIT,P ARM= 'MODE=INIT' 


Available Functions 
Reads any Media 
Performs Read, Update, Add, pr 
Database record. 
Delete functions on volume 
records only. 


Sequential Read 
Supported by the 
Not suppoI'ted. 


READNEXT function, 


Authorization· Required 
None. 
APF authorization. 


fromi the Calling 


Program 


Keyed/ Non-keyed 
Both keyed and non~keyed Only keyed access supported. 
Access 
(RBA based) access ave 
supported, 


Media Database 
The calling p:r:ogram must 
The calling p11ogram does not 
Allocation, 
allocate DAMDB, DAMDl 
need to. allocate Database 
and DATRC files. 
components. The Real-Time 
Environment Data file, Index 
file, and Trace file are allocated 
automatically for the calling 
program, 


Load of CONTROL-T 
The calling p11ogram must 
The calling p11ogram need not 


Control' Table (TCT) 
load a CONTROL-T 
load a CONTROL-T Control 
Control Table (TCT). 
Table (TCT). The Real-Time 
Environment TCT is accessed 
for the calling p11ogram, 


CONTROL-T Real-Time 
Base Level API can be 
High Level API' can be used 
Environment 
used whether or not the 
only if the CONTROL-T Real- 


CONTROL-T Real-Time 
Time Environment is active. 
Environment is active. 
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Base Level API 


When accessing the Media Database, the Base Level AP!' can' perfo11m the following 
functions: 


OPEN 


READ 


READ NEXT 


CLOSE 


Access of the Media Database must begin with a request to open the 
database. 


This request reads a reco11d. This function is generally used for reading 
specific· records. 


Reads the recovd(s) following the specified record, Le., the next record(s). 
This function is generally used for reading a series of records. 


Access of the Media Database must end with a request to· close the 
database. 


Record Access by the Base Level API 


As mentioned earlier, records in the database can be accessed by non-keyed or keyed 
methods: 


• To. perform non~keyed access of database recovds, the full RBA must be specified. 


• To perfovmi keyed' access of database records, the value specified depends on the function 


perfovmed: 


- 
To perform a READ NEXT operation, the entire index recovd must be specified. 


- 
To perform a READ operation1 it is sufficient to use a partial key. Of couvse, the full' key 
or even, the full index record can1 be used. 


Both READ and READNEXT requests return the full index record to the area pointed to 
by parameter KEY=. 


A READ request is usually used 
1 for accessing a specific recovd. Since a READ request can 
use a partial keys as input, it is also useful when you have only partial data available 
(e.g., a volser without a label number when using the L-type index). 


A READNEXT request is usually used for accessing series of recovds. Since, however, a 
READNEXT request requires specification of a full input value (whereas a READ request 
can use a partial key as an input value), a sequence of READNEXT requests must be 
preceded by a READ req:uest. 


Macro CTTIOS 


CONTROL-T APis use macro CTTIOS to access the Media Database. However, before the 
Base Level APl can use macro CTTIOS, the CONTROL-T Control Table (TCT) must be 
loaded. 


Instructions for loading the TCT are included in the examples for Base Level API later in 
this section~ 
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Format 


Instructions for macro CTTIOS are formatted. as follows: 


Label 


Note 


CTTIOS 
request-type, 
function-code, 
RC=reason-code-field, 


[ENV=envir-id, ] 


[TCT=tst-address,] 


[DBGLVL=debug-level,] 
[REC=buffer-address,] 


[RBA=field,] 


[DATA=Y/N,] 


[KEY=key-field, ] 


[KEYTYPE=key-type,] 


[KEYLEN=key-length,.] 


[MF={L,(E,list-address)}] 


Macro CTTIOS may contain other parameters and fields, but only the parameters 
described in this section should be used. Specification of other parameters can lead to 
unpredictable results, and these additional parameters may·not be·supported in future 
releases ofCONTROb-T. 


Parameters 


request-type 
Type 0£ the request from macro CTTIOS. Mandatory. This parameter 
must always be included as the fivst pavameter in the macro· instructions. 


Valid.values are: 


function~code 
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VOL 


DS 


ANY 


Volume data requests. 


Dataset data requests. 


Both volume and dataset data requests. 


Function requested from macro CTTIOS. Mandatory. This pavameter 


must always be included as the second parameter in' the macro 
instructions. Valid values are: 


OPEN 
Open the Media Database (to establish access to the 
Media Database). 


CLOSE 
Clbse the Media Database (to tevminate access to the 
Media Database). 


READ 
Readdata fromithe Media Database. 


READNEXT 
Read the next data itemfromithe Media Database. 


These functions are described in more detail in "Base Level API Access of 
the Media Database" later in this section, 
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ENV 


TCT 


DBGLVL 


REC 


RBA 


DATA 


KEY 
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Points to a four-byte a11ea into which macro CTTIOS places the reason 
code. Mandatory for all request types and.function codes. 


Note 
The reason code should not be confused with the return code 
located in register 15 (described later). 


Reason, codes are extremely useful when, analyzing the reasons a request 
failed, and should· be kept for debugging and erro11 handling purposes. 
Reason code explanations can be found in the description of message 


CTT200S in the IOA Messages and1 Codes Manual~ 


Points to a four-byte field which identifies the environment under which 
the Media Database is opened. Mandatory for Media Database OPEN 


requests. 


The value specified in the ENV = parameter is passed to user exits and is 
recorded in the Trace file when Media Database updates are performed. 


Address of the TCT returned by macro CTTTLD. Mandato11y for Media 
Database OPEN requests. 


One-byte field specifying the tracing level to be used for further 
executions of macro CTTIOS. Mandatory for Media Database OPEN 


requests. It should contain value X'OO'. 


The buffer into which macro C'ITIOS puts data retrieved from the Media 
Database .. Mandatory for READ requests. REC should point to an area large 
enough' to hold the data record retrieved frmm the database by the macro. 


Record location identifier used to· determine which record should be 
retrieved from the Data file. 


For READ requests, the field should specify the RBA of the record to be 
read (011 X'OOOlOO' for the first recoi;d). For READNEXT requests, the 
field should specify the RBA of the record preceding the record to be read 


(Le., the RBA returned by the previous READ/READNEXT request). 


Whether or not to read the Data reco11d of the specified dataset/volume. 


Valid only when the READ or READNEXT function code (described 
above) is specified~ Valid values ave: 


YES 


NO 


Read the Data reco11d of the specified dataset/volume. 


Do 
not read the Data reco11d 
of the specified 
dataset/volume. 


Points to a valid index record (mapped by macro CTTDVX, CTTDDX or 


CTTDLX, described eavlier in this section) that serves as the key (or 
partial key) by which macro CTTIOS retrieves the data record from the 
Media Database .. Valid for~ READ requests. This pavameter is related to 
parameters KEYTYPE and KEYLEN. 


For READ requests, this field' should specify the key (011 partial key) of 
the record to be read. For READNEXT requests, this field should specify 
the key of the record preceding the record to be read· (Le., the key 
returned by the previous READ/READNEXT request). 


IOA Rel; 5.0;0Adininistrator Guide 
7-49 


Section 7: Customizing and Administering CONTROL-T 


KEYTYPE 


KEYLEN 


MF 


7-50 


Type of index being used, Valid when1 accessing data records that may be 
pointed to by more than one index type (i.e., dataset records). 


Because volume records a.Ile indexed by only one key type (the V-type 


index), this parameter should not be specified when performing keyed 
access of volume reco11ds. 


When perfo:ro:ning keyed access to the dataset reco11ds, valid values are: 


D 


L 


When using the D-type key (mapped by DSECT 


CTTDii>X) .. Default. 


When, using the L-type key (mapped, by DSECT 


CTTDI'.X). 


Points to a four-byte field which specifies the length of the key to be 
searched. The record length of the Index file is identical for all index 
types; therefo11e, this parameter is useful, when using an index value 


shorter than, the maximum index length of the file, or when using a 
partial key. 


Parameter KEYLEN should, be used with both fulli keys and partial keys. 


Set all! necessary fields in the key area (pointed to by pavameter KEY) 
and specify a KEYLEN parameter that includes only the desived fields. 
When, the full key is specified, set the pavameter KEYLEN to the full 


length 0£ the key field. This is demonstrated in the examples provided in 
this section. 


Macro CTTIOS reads the entire index record into the area specified by 
parameter KEY. Therefo11e, when using this parameter, be sure to 
allocate sufficient sto11age for the entire index record, or storage overlays 
will occur. 


Macro invocation form.Valid values a.Ile: 


L 


E 


Listfo11m 


Execute form1 


Generate all required data areas. 


Perform the request specified by the 
macro· parameters using the data 
areas generated by the List form of 
the macro. When the Execute form 


of the macro is used it must be 
accompanied, by a pointer to. the List 
form of the macro. 


This same list form address must be 
used for all subsequent accesses of 
the Media Database via macro 


CTTIOS until the Media Database is 
closed. 


All invocations of macro CTTIOS should access the same parameter avea. 


It is therefo11e preferable to. specify the combined Execute and List forms 


of the macro. 
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Macro CTTIOS must be coded' in accol1dance with all standard macro Assembler coding 
restrictions. 


The values in general purpose registers 0, 1and14 are modified by macro CTTIOS. 


Macro CTTIOS accesses a set of variables generated by macro CTTDBTP. Therefore, 
macro CTTDBTP should be included' in the source code of the calling program, 


Return Codes 


Macro CTTIOS returns a return code in general' purpose register 15. This should not be 
confused with the reason code returned in parameter RC described above. 


0 


4 


Greater than 4 


Successful execution of the request 


Requested record not found(READ requests) I End-of-File (READNEXT 
requests) 


Unsuccessful execution of the request; the reason-code indicates 
additional information regarding the reason fo11 failure of the request. 


For more details on the return, codes and reason codes of macro. CTTIOS, see the description of 
message CTT200S in the IOA Messages and Codes Manuah 


Base Level API Access of the Media Database 


Note 
Sample macro code and examples are provided later in this section. 


Opening/Closing Files 


Access of the Media Database must begin with an OPEN request. The OPEN request 
automatically opens the Data, Index and Trace files. A Media Database OPEN request 
should be accompanied by parameters ENV, TCT and DBGLVL (described, earlier). 


Access of the Media Database must end with a CLOSE request. The CLOSE request 
automatically closes all the files and pe11forms all other required activities. 


Reading Files 


As mentioned earlier, Media Database READ requests can be made using either of the 
follbwing function' codes: READ and READNEXT. 


The differences between these requests should be understood if they are to be used 
effectively. These function: codes, the correlation' between them and the various key and 
RBA related parameters are described below. 


READ Requests 


The READ request is used to read' a specific data record from the Media Database. The 
READ request locates the requested' data record and retrieves it into the area specified by 
the REC= parameter. 


Either a keyed or non-keyed: (i.e.,. RBA) access method can' be used to specify the record to be 


read. 
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When using keyed access to performr a READ fromr the Media Database, either a full: or 
partial key can be specified. The READ request returns the whole index reco11d (0£ the 
data record being read) into the area specified by parameter KEY=. Therefore, even when 
using a partial key, parameter KEY= must specify an area large enough to contain the 
whole index reco11d (not just the partial key). 


If the requested record is not found, either because there is no· record at the specified RBA or 
because no record exists with the specified full1 or partial, key, macro CTTIOS returns a return 
code of 4. 


Using the READ request in conjunction with partial keys is useful fo11 reading from the Media 
Database whenyouhave pavti.al,data only. 


For example, assume you know a volser and want to· find the name 0£ the first dataset on the 


volse11, but you do not know the label' number for this dataset (e.g;, the first label may belong to 
a file that is already expired) . .ln this case, you can use partial keys as follows: 


Select request type VO!:,, specify KEYTYPE=b and set the VOLSER field in, the L-type index to 
the known volser. Instead of specifying the label number, read using a KEYLEN = pwameter 


that includes the volser number but does not include the label, number. Macro CTTIOS then 
retrieves the first reco11d that matches the volser number, which is the dataset recovd 0£ the 
first label number that exists fov this volser. The wea specified by the key field wiU be updated 
with the full-key value o£the retrieved recovd. 


READNEXT Requests 


The READ NEXT request is used to. read the next data record(s) mom the Media Database. A 
READNEXT request can be used with either an RBA or a fuU index record. READNEXT finds 
and reads the record (matching the request type specified in macro CTTIOS) that follows the 
specified RBA or index (i.e., the next reco11d), and then updates the KEY= field or RBA= field 
with the correspondingvalue of the reco11dbeingread, 


Because READ NEXT requests require specification of an RBA value 011 a full index record, and 
because READ requests always stove the RBA value or the full index reco:rid 0£ the recovd read, 
a READ request should always precede a READNEXT request or set of READNEXT requests. 
The READ request can be specified with either the RBA= or KEY= parameters and partial 
keys can be used; The READNEXT request should then be specified without explicitly 


modifying the value in' the KEY or RBA fields, and without specifying parameter KEYLEN. 


Because both READ and READNEXT update the key or RBA value with each invocation, it is 
possible to follow the READ request with more than one READ NEXT request.. Each 
READNEXT request will~ in its turn, read, the next record and update the index record 
(pointed to· by the KEY parameter) 011 the RBA (pointed to, by the RBA pwameter) to the value 
corresponding to the record being read. 


The READNEXT function is generally used for reading a series of recovds in the Media 
Database,.suchas all records matching a prefix, or all records until: the end-of-file. 


For example, to read all records that match a dataset name prefix, first specify a READ with 
the pa:ritial: key (the dataset prefix) followed by one or more READNEXT requests. The first 


recovd matching the dataset prefix will be read (if one exists), and the READNEXT requests 


will read, all subsequent records (datasets) following the fust match; If no matching reco11d 


exists, CTTIOS positions the program for subsequent READNEXT requests acco11ding to 
ordinary key sorting rules. 
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A READ NEXT operation does not automatically stop· after all records matching the 
prefix (or any other partial key) are read: The READNEXT request stops reading, and 
returns a return code of 4, only when the end-of-file is reached. Therefore,. your 
application program must check when the READNEXT request results in a record that 
does not match the partial key, and stop issuing more READ NEXT requests. 


Sequential Reading of the Entire Media Database - Keyed vs. Non-Keyed Access 


The entire Media Database can be read either by using indexes (e.g., reading all volsers by 
using the V-type index) or by using RBAs to read through the entire Media Database. 
Every program that requires sequential access to the entire Media Database must select 
the appropriate access method. When selecting the access method, the following points 
should be considered: 


• When. reading the Media Database using RBAs, one I/O operation is performed for each 
block (one block contains a number of reco11ds). Thus, the number of I/O operations requi11ed 


for reading the entire Media Database is relatively smalll When reading the Media 
Database sequentially via indexes, each reco11d access results in one access to the index, and 
one access to· the data. This may result in a high I/O count and less than satisfying 


performance for the program. 


• When reading the Media Database via indexes, records are read in ascending sort order. 
When reading the Media Database using RBAs, records are read in the order they appear in 
the data file (not necessarily sorted). 


It is much faster to read the Media Database using RBAs rather than using indexes. If 
data items from the Media Database do not have to be sorted, it is highly recommended to 
use RBA-based reading of the Media Database. 


Even' if the data items retrieved from the Media Database should be sorted, it might be 
more efficient (depending on the environment) to read the Media Database using RBAs, 


and· sort it after you have read it. You can, also use so11t utilities to merge volume and 
dataset records retrieved from the Media Database, instead of performing keyed accesses 
for every volume (011 for every dataset). 


Examples for Base Level API 


Below are several examples of how to perfo11m the various functions described in this 
section. Note, however, that these are examples and should not be used without appropriate 
modification. Most of the examples p11ovided do· not check the return· code from macro 


CTTIOS. Some examples refer to Assembler symbols that are not included in the example. 


Loading the TCT into Storage 


The TCT (CONTROL-T Control Table) is not a load module and therefore cannot be loaded 
usingthe LOAD macro. Toloadthe TCT, use macro CTTTLD. Below is a sample program 


which uses macro CTTTLD to load the TCT. 
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Sample TCT Load Request 


CALL 


L'l'R 


BNZ· 


CT'l'TLD 1 (LOAD, TCTADDR, 0 ,, 0 ') 


R15,R15 


TCTFA:CL 


LOAD· THE TCT 


SUCCESSFUL? 


NO - 
TERM:CNATE 


TCTFA:CL · W'l'O 
'TCT LOAD FA:CLED, PROGRAM TERM:CNATED' 


ABEND· 
8., DUMP· ABEND PROGRAM W:CTH UO 0 0 8 


LOAD 
DC 


TCTADDR 
DS 


CL8'L0AD' 


A 


CONSTANT FOR CT'l'TLD 


ADDRESS OF TCT 


Sample Media Database OPEN Request 


CALL 
C'l'TTLD, (LOAD, TCTADDR1 0 , 0 1) 
Load the TCT 


L 
R12,TCTADDR 


OPENMDB 
C'l'T:COS ANY,OPEN,ENV=$ENV,DBGLVL=$DBG,TCT=(R12), 


RC=RESCODE,MF=(E,:COSLJ:ST) 


Open the MDB 
* 


:COSL:CST 


$ENV 


$DBG 


TC TAD DR 


RESCODE 


LOAD 


CTTJ:OS 


DC 


DC 


DS 


DS 


DC 


MF=L· 


CL4'USER' 
x•oo• 


A 


F 


CL8'LOAD' 


Environment specification, 


Debug level 
Address of TCT 


Constant for C'l'TTLD 


Note 
The return code from macro CTTTLD should also be checked. 


Sample CLOSE Request 


CLOSEMDB 
CTT:COS ANY,CLOSE,MF=(E,:COSL:CST) 


:COSL:CST 
CTT:COS MF=L · 


Keyed Reading From the Media Database 


CONTROL-T Base Level APT p:r:ovides keyed access to data residing in the Media 
Database. Keyed access is achieved using the indexes, as explained above. 
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Following are samples fov keyed access requests from the Media Database: 


Sample ''Read by Volser" Request 


L 
R2,=A(VOIIKEY) 
Vo1ume key field 


USING 
DVX,R2 


XC 
VOLKEY,VOLKEY 


MVC 
DVXVOLSR,=C'123456' 
Prepare vol. key 


LA 
R15, =A (L. DVXVOLSR) 
Length of vo1ser 


READVOL 
CTTIOS VOL,READ,KEY=VOLKEY,RC=RESCODE,REC=VOLREC, 
Read from MDB * 


KEYLEN=(R15),MF=(E,IOSL:CST) 


VOLKEY 


VOLREC 


RES CODE 


IOSL:CST 


LTR 


BNZ 


DS 


DS 


R15,R15 


NOTFOUND 


XL(DVXLEN) 


XL(DVLLEN) 


DS 
F 


CTTIOS MF=L · 


* CONTROL-T MAPPING MACROS 


CTTDVL· 


CTTDVX 


CTTDBTP· 
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Was read OK? 


No - treat accordingly 


Vol. index key 


Vol. record buffer 


CTTIOS reason code 


CTTIOS list form 


Vol. data record 


Vol. index record 


CTTIOS parameters block 
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Sample ''Read by Dataset Name'' Request 


Since D-type indexes are non~unique (i.e., move than one dataset may have the same 
name) the sample shown below will read only the recovd of the first dataset in the Media 
Database with the specified name. 


LA 
R2,DSNXEY 
D.S. key field 


USING 
DDX,R2 


XC 
DSNXEY,DSNKEY 


MVC 
DDXDSN,=CL44'CTT.SAMPIIE.F:CLE' 
Prepare D.S. key 


LA 
R15,=A(L'DDXDSN) 


CTT:ros DS1READ,KEY=DSNXEY,REC=DSNREC, 
Read from MDB 


KEYLEN=(R15),ENQ=Y,MF=(E,:COSL:CST) 


LTR 


BNZ 


DSNXEY 
DS 


DSNREC 
DS 


RESCODE 
DS 


R15,R15 


NOTFOUND 


XL(DDXLEN) 


XL(DDSLEN) 


F 


:rosLZST 
CTT:ros MF=L 


* CONTROL-T MAPPING MACROS 


CTTDDS 


CTTDDX 


CTTDBTP 


Was read OK? 


No - treat accordingly 


D.S. index key 


D.S. record buffer 


CTT:COS reason code 


CTT:ros list form 


D.S. data record 


D.S. index record 


CTT:COS parameters block 


* 


Note 
In the above example, the KEYTYPE parameter is omitted. It defaults to 
KEYTYPE=D. 
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Sample "Read by Volser and File Sequence Number" Request 


DLSKEY 


DSNREC 


RESCODE 


J:OSL:CST 


R2,DLSKEY 


DLX,R2 


DLSKEY,DIISKEY 


DLXVOLSR,=C'l23456' 


R3,l 


D.S. key field 


Copy vo1ser 
First D.S. on,volser 


LA 


USJ:NG 


xc 


MVC 


LA 


STCM 


LA 


R3, B' 0 0 !l.1' , DLXLBLNM 
Store label number 
R15, =A (LI DLXVOLSR+L I DLXLBLNM): 


CTT:COS DS,READ,KEY=DLSKEY,KEYIIEN=(R15),KEYTYPE=L, 
Read from MOB 


REC=DSNREC,MF=(E,J:OSL:CS'l') 


LTR 


BNZ 


R15,R15 


NO'l'FOUND 


OS 
XL(DLXLEN) 


DS 
XL(DDSLEN) 


OS 
F 


CT'l'J:OS MF=L 


Was read OK? 


No - treat accordingly 


D.S. L-type key 


D:.S. record buffer 


C'l"l'J:OS reason code 


C'l"l'J:OS list form 


* CON'l'ROL-T MAPP:CNG MACROS 


CTTDDS 
D.S.data record 
o.s.L-type index 
C'l''l'DLX 


CTTDB'l'P 
C'l''l'J:OS parameters block 
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Sample "Read All Datasets With Specified Prefix" Using the READNEXT Request 


LA 
R2,DSNKEY 
D.S. key field 


US:CNG 
DDX,R2 


L 
R3,=A(DSNREC) 
Reco:r::id addressability 


US:CNG 
DDS,R3 


xc 
DSNKEY,DSNKEY 
Clear index 


MVC 
DDXDSN (L 1 DSPRFX)., DSPRFX 
Dataset•s prefix 


LA 
R15, =A (L ·' DSPRFX) 
Length of p:r::iefix 


CTT:COS DS,READ1KEY=DSNKEY,REC=DSNREC, 
Read from MDB 


KEYLEN=(R15),MF=(E,:COSL:CST) 


READNEXT CTT:COS DS,READNEXT,KEY=DSNKEY, 


REC=DSNREC,MF=(E,:COSLIST) 


L'il'R 
R15,R15 


BNZ 
NOMORE 


CLC 
DDSDSN ( L' DSPRFX)., DSPRFX 


BE 
READNEXT 


NOMORE 
EQU 


DSPRFX 
DC 
CL15'DATASET.PREF:CX.' 


DSNKEY 
DS 
XL(DDXLEN) 


DSNREC 
DS 
XL(DDSLEN) 


RESCODE 
DS 
F 


:COSLIST 
CTT:COS MF=L 


* CONTROL-T MAPP:CNG MACROS 


CTTDDS 


CTTDDX 


CTTDBTP 


Read next dataset from MDB 


Successful ? 


No - skip further READNEXTS 


:cs it still the same 


Yes - loop again 


Dataset•s prefix 


D.S. index key 


D.S. reco:r::id buffer 


CTT:COS reason, code 


CTT:COS list form 


D•S. data record 


D.S.index record 


prefix 


CTT:COS parameters block 


Non-Keyed (RBA-Based) Reading of the Media Database 


* 


* 


* 


CONTROL-T Base Level AP! also provides non-keyed access to· data residing in the Media 
Database. Non"keyed access is achieved by using the RBA as the pointer to the desired 
record in the data file, as explained above. 


Following are a few samples fo11 REA-based access requests from the Media Database: 
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Sample ''Read a Record" Request 


MVC 
RECRBA,=X 1 000203 1 
Set the RBA to block 2, record 3 


CTT:IOS ANY,READ,RC=RESCODE,REC=AREA,RBA=RECRBA, 
Read from MOB 
* 


MF=(E,:IOSLI:ST) 


LTR 


BNZ 


L 


US:ING 


CLI: 


BE 


CLI: 


BE 


B 


AREA 
DS 


RECRBA 
DS 


R15.,R15 


NOTFOUND 


R3,=A(AREA). 


DVL,R3 


DVLRTYPE,DVLRVL 


TREATVOL 


DVIIRTYPE,DDSRDS 


TREATDS 


TREATOTH 


CL(DVLLEN) 


XL3 


* CONTROL-T MAPP:ING MACROS 


CTTDVL. 


CTTDDS 


CTTDBTP 


In the above example: 


Does record exists ? 


No - treat accordingly 


R3 points. to the record read 


:Is it a volume record ? 


Yes - treat accordingly 


:Is it a dataset record ? 


Yes - treat accordingly 
Treat other record types 


Record buffer (both vol and D.S.) 


RBA of record 


Vol. data record 


D.S. data record 


CTT:IOS parameters block 


• You do not have to check whether or not the reco11d being read is free or active, since macro 


CTTIOS does that for you~ If the record is free, the macro returns a return code of 4 (not 
found). 


• Smee the header of all reco:rid types is the same, it is possible to compare the record type 
FIELD from the volume DSECT against the record type EQl:JATE from the dataset DSECT. 


Sample ''Read Next Record" Request 


MVC 
RECRBA,DVLRBA 
Set RBA of current record 


CTTl:OS ANY,READNEXT,REC=AREA, 
Read the next record from MOB 
* 


RBA=RECRBA,RC=RESCODE,MF=(E,:IOSLI:ST) 


LTR 
R15,R15 


In the above example: 


• The rest 0£ the sample program may be the same as the prio11 example. 


• When using the READNEXT function code, macro CTTIOS skips free reco11ds and looks for 
active records to read, A return code 0£ 4 (not found) signals that the end-of-file was 


reached~ 
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Sample Media Database Access Program 


The sample access program sequentially reads all the Media Database using RBAs and 
produces the following repol'ts: 


• All volumes with, aU the datasets for each volume. 


• All datasets with all! the volumes for each dataset. 


This program provides a wovking example fov a wide variety of requests available through 
macro CTTIOS. 


********************************************************************** 
* 
* 
* 
CTTSAM1 
* 
* 
* 
* 
* 
* 
FUNCT:CON: SAMPLE PROGRAM TO DEMONSTRATE ACCESS TO THE CONTROL-'!' 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 


MED:IA DATABASE 
(MDB) 
US:CNGTHEBASE LEVELAP:C. 


THE PROGRAM READS THE MDBAND PRODUCES TWO REPORTS: 


1. A VOLUME REPORT CONTA:CN:CNG ALL· VOLUMES· :CN THE MDB 


AND ALL DATASETS EX:CST:CNGON EACH VOLUME 


* 
* 
* 
* 
2. A DATASET REPORT CONTA:CN:CNG ALL DATASETS :CN THE MDB * 


AND ALL VOLUMES THAT ARE PART OF EACH DATASET 


RETURN CODES: 00 


04 


08 


OK 


MDB EMPTY 


ERROR DUR:CNG PROCESS:CNG 


* 
* 
* 
* 
* 
* 
* 
* 
LOG:CC: THE PROGRAM READS THE MDB SEQUENTJ:ALLY US:CNG RBAS. VOLUME * 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 


AND DATASET RECORDS ARE PROCESSED, AND OTHER RECORDS ARE 
* 


DJ;SREGARDED. 
* 


FOR VOLUME RECORDS, 
THE DATASETS OF THE VOLUME ARE READ1 * 


US:CNG THE L-TYPE :CNDEX. 
A READ REQUEST W:CTH NO LABEL 
* 


NUMBER 
(VOLSER ONLY) 
:CS PERFORMED F:CRST. 
THE READNEXT 
* 


REQUEST :CS THEN USED REPEATEDLY UNT:CL ALL DATASETS ON THE * 


VOLUME ARE PROCESSED• 
* 


FOR DATASET RECORDS, 
THE.VOLUMES• OF THE DATASET ARE READ* 


THE F:CRST VOLSER :CS TAKEN FROM THE DATASET RECORD, 
AND 
* 


AFTERWARDS, 
THE VOLUME.RECORDS ARE.BE:CNG READ, 
AND THE 
* 


NEXT VOLUME RETR:CEVED FROM THEM, UNT:CL ALL VOLUMES OF THE * 


DATASET HAVE BEEN READ. 


DD· CARDS: 
DAMDB 


DAMD:C 


DATRC 


- 
MDB DATA F:CLE 


- 
MDB :CNDEX F:CLE 


- 
TRACE F:CLE 


DARPTVOL - 
VOLUME REPORT F:CLE 


DARPTDSN - 
DATASET NAMES REPORT F:CLE 


* 
* 
* 
* 
* 
* 
* 
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* 
* 
* 
DISCLAIMER: 
THIS SAMPLE PROGRAM IS PROVIDED ON AN AS IS BASIS1 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 


WITHOUT ANY WARRANTY, 
EITHER EXPRESS OR IMPLIED 


REGISTERS: R13 


R2 


R3 


- 
BASE 


- 
MDB RECORD KEY 
(WHERE APPIIICABLE) 


- 
MDB RECORD BUFFER 


ATTRIBUTES: AMODE 31 


RMODE 24 


TO COMPILE AND LINK THE PROGRAM 


//CTTSAMl JOB ••• 


//ASM 
EXEC CTTASM 


//C.SYSIN DD DSN=CTT.V210.SAMPLE(CTTSAM1) 


I IL. SYSLMOD DD, DISP=SHR,.DSN=YOUR. LOAD. LIBRARY 


//L.SYSIN 
DD * 


INCLUDE SYSLIB(CTTTLD) 


MODE RMODE(24),AMODE(31) 


NAME CTTSAMl(R) 
II* 


//RUN EXEC PGM=CTTSAM1,COND=(01NE),REGION=60M 


// STEPLIB DD DISP=SHR1.DSN=YOUR. LOAD. LIBRARY 


//DAMDBDD DISP=SHR,DSN=CTT.V210.MDBD 


//DAMDI DD DISP=SHR<DSN=CTT.V210.MDBI 


//DATRC DD DISP=SHR,DSN=CTT.V210.TRC 


//DARPTVOL DD SYSOUT=* 


//DARPTDSN DD SYSOUT=* 
II 


* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
********************************************************************** 


EJECT 


CTTDDS 


CTTDVL 


CTTDVX 


CTTDDX 


CTTDLX 


CTTDBTP 


EJECT 


MACRO 


&:NAME 
MYPUT &:DCB, &:REC 


&:NAME 
LA 
R15,*+6 


BAS SM R14,R15 
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D.S. 
DATA RECORD 


VOL. 
DATA RECORD 


VOII. 
INDEX RECORD 


D.S. 
INDEX RECORD 


D.S. 
L-TYPE INDEX 


CTTIOS PARAMETERS BLOCK 


ADDRESS FOLLOWING BASSM 


CHANGE AMODE 
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PUT 


LA 


&DCB,&REC 


R15,*+10 


0 
R15,=X'80000000' 


BSM 
O,R15 


MEND 


PUT 'l'HE DES:CRED RECORD 


END:CNG ADDRESS 


********************************************************************** 


EJECT 


CTTSAM1 
CSECT 


*** 


BEG:CN *,EQUR=YES 


C'l"l'LEVEL· 


SPACE 3 


* :CN:CTJ:AL:CZE PROGRAM - 
LOAD THE TCT AND OPEN F:CLES 


*** 


*** 


CALL 
CTTTLDI (LOAD, TCTADDR, 0·, 0) 
LOAD THE TCT 


LTR 
R15,R15 
SUCCESSFUL· ? 


BNZ 
L'l'CTFA:CL· 
NO - 
TERM:CNATE 


SPACE 3 


OPEN 
(RP'l'VOL, OUTPUT)' 
OPEN VOLUME REPORT OUTPUT F:CLE 


L'l'R 
R15,R15 
SUCCESSFUL. ? 


BNZ· 
OUTERROR 
NO - 
'l'ERM:CNATE 


OPEN 
(RPTDSN, OUTPUT) 
OPEN DATASET REPORT OUTPUT F:CLE 


LTR 
R15,R15 
SUCCESSFUL ? 


BNZ 
OUTERROR 
NO - 
TERM:CNATE 


MYPUT RP'l'VOL,VOLMSG 
PR:CN'l' VOLUME REPORT HEADER 


MYPUT RPTDSN,DSNMSG 
PR:CN'l' DATASET REPORT HEADER 


SPACE 3 


L 
R12,TCTADDR 


MVC 
MSGOP1=CL8 1 0PEN' 


C'l"l':COS ANY,OPEN,ENV=$ENV,DBGLVL=$DBG, 
OPEN MDB 


TCT= ( R12 ) I RC=RESCODE, MF= ( E, :COSL:CST). 


LTR 


BNZ 


R15,R15 


MDBERROR 


SPACE 
3 


SUCCESSFUL· ? 


NO - 
TERM:CNATE 


* SEQUEN'l':CAL READ:CNG OF THE MDB, 
BY RBA 


*** 


MVC 
RECRBA,RBAO 
START W:CTH THE F:CRST RECORD· 


MVC 
MSGOP, =CLB •• READ I 


C'l"l':COS ANY,READ,RC=RESCODE,REC=AREA,RBA=RECRBA, 
* 


MF= (E, :COSLJ:ST) 
READ THE F:CRST RECORD 


L'l'R 
R15,R15 
SUCCESSFUL ? 


BZ 
READOK 
YES - 
PROCESS THE.NEXT RECORD 


CH 
R15,=H'4' 
WAS :CT BECAUSE F:CRST RECORD :CS 


* 


FREE? 
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BH 
MDBERROR 
NO - 
'l'ERM:CNA'l'E 
* 


O'l'HERW:CSE 'l'RY 'l'O READ 'l'HE. NEX'l' ONE 


MVC 
MSGOP,=CL8'READNEX'l'' 


C'l"l':COS ANY,READNEX'l',RC=RESCODE,REC=AREA, 
READ NEX'l' RECORD 
* 


L'l'R 


BZ 


CH 


BE 


B 


SPACE 


*** 


RBA=RECRBA,MF=(E,:COSL:CS'l') 


R15,R15 


READOK 


R15.,=H'4' 


MDBEMP'l'Y 


MDBERROR 


3 


WAS READNEX'l' SUCCESSFUL ? 


YES - 
PROCESS 'l'HE RECORD 
E.O.F ? 


YES - 
MDB :CS· EMP'l'Y 


O'l'HERW:CSE - 
'l'ERM:CNA'l'E 


* LOOP ON ALL RECORDS 


*** 


READOK 


READNEXT 


*** 


EQU 
* 
L 
R3,=A(AREA) 
ES'l'ABL:CSH ADDRESSAB:ILI'l'Y 


US:ING DVL,R3 
'1'0 'l'HE RECORD BUFFER 


CLJ: 
DVLR'l'YPE, DVLRVL · 
IS 'l'H:CS A VOLUME RECORD ? 


BE 
'l'REA'l'VOL 
YES - 'l'REA'l' ACCORD:CNGLY 


CLI 
DVLR'l'YPE,DDSRDS 
:CS 'l'H:CS A DA'l'ASE'l' RECORD ? 


BE 
'l'REA'l'DS 
YES - 'l'REA'l' ACCORD:CNGLY 


EQU 
* 
MVC 
MSGOP,=CLS'READNEXT' 


C'l'T:COS ANY,READNEX'l',RC=RESCODE1REC=AREA, 
READ NEXT RECORD 
* 


RBA=RECRBA,MF=(E,:COSLIST) 


L'l'R 


BZ 


CH 


BE 


B 


R15,R15 


READOK 


R15,=H'4' 


EODAD 


MDBERROR 


DROP 
R3 


SPACE 3 


WAS READ SUCCESSFUL ? 


YES - 
PROCCESS 'l'H:CS RECORD 
E.O.F ? 


YES - 
:CSSUE MESSAGE 


O'l'HERW:CSE TERM:CNATE 


* 'l'REA'l' ONE VOLUME RECORD - 
PR:INT ALL :CTS DA'l'ASETS 


*** 


'l'REA'l'VOL EQU 
* 


US:ING DVL,R3 
ESTABL:CSH ADDRESSABIL:C'l'Y 


MVC 
VOLUME,DVLVOLSR 
MOVE VOLSER 'l'O OUTPUT RECORD 


MYPUT RP'l'VOL, OUTVOL · 


TM 
DVLSTAT, DVLSSCR 
:cs :CT SCRATCH ? 


BNO 
GETDSNS 
NO - 
GET DATASETS ON THE VOLUME 


MVC 
DSNAME,SCR:CND 
ELSE - 
:CSSUE SCRATCH MESSAGE 


MYPU'l' RP'l'VOL,OUTDSN 
PR:CNT THE SCRATCH MESSAGE 


B 
ENDVOL 
END VOLUME PROCESS:CNG 
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GE'l'DSNS 
EQU 


LA 
* 


R2,DLSKEY 


US:CNGDLX,R2 


xc 


MVC 


DLSKEY,DLSKEY 


DLXVOLSR1DVLVOLSR 


DROP· 
R3 


LA 
R15, =A (L 'DLXVOLSR). 


MVC 
MSGOP, =CL8 •'READ·' 


ES'l'ABL:CSH ADDRESSAB:CL:C'l'Y 


'l'O D.S. 
L-'l'YPE :CNDEX 


CLEAR :CNDEX F:CELD 


MOVE VOLSER 'l'O KEY F:CELD 


VOLUME RECORD NO'l' NEEDED ANY MORE 


C'l"l':COS DS,READ,KEY=DLSKEY, 
READ FROM MDB 


RC=RESCODE, 
*RC 


KEY'l'YPE=L,KEYLEN=(R15) ,REC=AREA,MF=(E,:COSL:CS'l')• 


CH 


BE 


BH 


R15,=H'4' 


ENDVOL 


MDBERROR 


PR:CN'l'DSN EQU 
* 


US:CNG DDS1R3 


MVC 
DSNAME,DDSDSN 


MYPU'l' RP'l'VOL,OU'l'DSN 


MVC 
MSGOP1=CL8 1 READNEX'l' 1 


*NFD· 


*NFDl 


*NFD 


ADDRESSAB:CL:C'l'Y 
(R3->>RECORD BUFFER). 


MOVE DSNAME 'l'O OU'l'PU'l' RECORD 


PR:CN'l' :C'l' 


* 
* 


C'l''l':COS DS,READNEXT,KEY=DLSKEY, 
READ·NEX'l' RECORD FROM MDB 
* 


RC=RESCODE, 
*RC 
* 


KEY'l'YPE=L,REC=AREA,MF=(E,:COSLI:S'l') 


L'l'R 
R15,R15 
SUCCESSFUL ? 


BZ 
PROCDSN 
YES - 
PROCESS DSN 


CH 
R15,=H'4' 
NO - 
WAS :CT BECAUSE THE END OF MDB ? 


BH 
MDBERROR 
NO - 
:CSSUE AN ERROR MESSAGE 


B 
ENDVOL 
YES· - 
PROCESS NEXT VOLUME 


PROCDSN 
EQU' 
* 


CLC 
DLXVOLSR:,VOLUME 
ARE WE S'l':CLL· :CN THE. SAME VOLUME ? 


BE 
PR:CNTDSN 
YES - 
PR:CN'l' :C'l' AND PROCESS NEXT DS 


END VOL 
EQU 
* 


B 
READNEX'l' 
GO TO GE'l' NEX'l' RECORD 


SPACE 3 


*** 


* TREAT ONE DATASET RECORD - 
PR:CN'l' ALL :CTS VOLUMES 


*** 


TREATDS 
EQU 
* 


US:CNG DDS,R3 
ES'l'ABLI:SH ADDRESSABI:L:C'l'Y 


MVC 
DSNAME,DDSDSN 
MOVE DSNAME TO OUTPUT RECORD 


MYPUT RPTDSN,OUTDSN 
PR:CNT :CT 


MVC 
VOLUME,DDSVOLSR 
MOVE F:CRST VOLSER TO MESSAGE 


MYPU'l' RPTDSN,OUTVOL 
PR:CN'l' MESSAGE 


LH 
R4,DDSVOLS# 
NUMBER OF VOLUMES :CN DATASET 


CH 
R4,=H'l' 
:CS THERE ONLY ONE VOL :CN DATASE'l' ? 
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*** 


BNH 
ENDDSN 


DROP 
RS 


SPACE 3 


YES - 
END PROCESSJ:NG OF DATASET 


ADDRESSABJ:LJ:TY NOT NEEDED ANY MORE 


* FJ:ND ALL VOLUMES OF DATASET 


*** 


NEXTVOL· 


ENDDSN 


* 


LA 


USJ:NG 


USJ:NG 


xc 


BCTR 


EQU1 


MVC 


LA 


MVC 


R2,DVXKEY 


DVX,R2 


DVL,R3 


DVXKEY,DVXKEY 


R4,0 


* 


DVXVOLSR1VOLUME 


R15,=A(L'DVXVOLSR) 


MSGOP,=CLS'READ' 


ESTABLJ:SH·ADDRESSABJ:LJ:TY 


TO VOLUME J:NDEX FJ:ELD 


AND· TO VOLUME RECORD 


CLEAR VOLUME KEY FJ:ELD 


DECREMENT VOL· COUNT 
( 1 PRJ:NTED) · 


CTTJ:OS VOL,READ;,KEY=DVXKEY, 
READ FROM MOB 


RC=RESCODE, 


REC=AREA,KEYLEN=(R15),MF=(E,J:OSLJ:ST) 


CH 
R15,=H'4' 


BE 
ENDDSN 


BH 
MOB ERROR 


MVC 
VOLUME,DVLNEXT 


MYPU'I' RPTDSN,OUTVOL 


BCT 


EQU1 


B 


R4 I NEXTVOL. 


* 


READ NEXT 


DROP 
R3 


SPACE 3 


NEXT VOLUME 
( PREV ALREADY PRJ:NTED) · 


PRJ:NT THE VOLUME SERJ:AL 


AND GO GET NEXT VOLUME 
(J:F ANY) 


END OF DATASET PROCESSJ:NG 


GO TO GET NEXT RECORD 


MDBERROR EQU1 * 


LR 
RS,R15 


CVD 
RS,DOUBLE 


UNPK 
MSGRC(2),DOUBLE+6(2) 


OJ: 
MSGRC+l,X'FO' 


* 
L 
RS,RESCODE 


CVD 
RS,DOUBLE 


UNPK 
MSGRSN(S),DOUBLE+S(3) 
or 
MSGRSN+4,X'F0' 


* 


J:OAEDJ:T 'CTT200S 
FAJ:LED·FOR DAMDB DATASET. 
1 ,(MSGOP,8), 


J:NTO=MDBERR1+8,REGSAVE=YES,MF=(E,WORKEDJ:T) 


MDBERR1 
WTO 
'CTT200S 
OPER 
FAJ:LED FOR DAMDB DATASET.' 


* 


J:OAEDJ:T 
I 
RC=_, REASON=_',(MSGRC,2,MSGRSN,5), 
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MDBERR2 
W'l'O 


* 
B 


OUTERROR W'l'O 


B 


Lll'CTFA::CL· WTO· 


B 


::CNTO=MDBERR2+8,REGSAVE=YES,MF=(E,WORKED::CT) 


RC=XX, 
REASON=YYYYY I 


RETS 


'UNABLE TO OPEN OUTPUT F::CLE' 


RETS. 


'TCT LOAD FA::CLED' 


RETS 


MDBEMP'l'Y W'l'O 
• MDB :rs EMPTY • 


RET4 


EODAD 


CALL· 


RETS 


RET4 


RETO 


ENDPGM 


*** 


B 


EQU 
* 


MYPUT RPTVOL,EOFMSG 


MYPUT RPTDSN,EOFMSG 


CLOSE 
(RPTVOL,,RPTDSN) 
CLOSE OUTPUT F::CLES 


CTT::COS ANY,CLOSE, 


RC=RESCODE, 


MF=(E,::COSLJ:ST) 


CTTTLD, (DELETE,TCTADDR, 0,, 0) 
FREE TCT AREA 


B 
RETO 


LA 
R15,8 


B 
ENDPGM 


LA 
R15,4 


B 
ENDPGM 


SLR 
R15,R15 


B 
ENDPGM 


EQU 
* 


SPACE 3 


BRTRN 
(15) 


EJECT 


* CONSTANTS 


*** 


RBAO 
DC 


$ENV 
DC 


$DBG 
DC 


LOAD 
DC 


DELETE 
DC 


PATTERN 
DC 


SPACE 


*** 


* DATA AREAS 


*** 


AREA 


RECRBA 


DS 


DS 


XL3'000100' 
RBA OF FJ:RST RECORD J:N DATABASE 


CL4'SAM1' 
x•oo,• 


CLS'LOAD' 


CLS'DELETE' 


X'402120202020' 


3 


CL {DVLLEN) 
RECORD BUFFER 
(BOTH VOL AND D.S. ) 


XL3 
RBA OF RECORD 


* 
* 
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RESCODE 
DS 


DLSKEY 
DS 


DVXKEY 
DS 


TCTADDR 
DS 


F 
REASON CODE OF PROGRAM 


XL(DLXLEN) 
D.S. 
L-TYPE J:NDEX KEY 


XL(DVXLEN) 
VOL. 
J:NDEX RECORD 


A 
ADDRESS OF THE TCT 


DOUBLE 


MSGRC 


MSGRSN 


MS GOP 


DS 


DS 


DS 


DS 


D 


CL6 


CL6 


CL8 


DS 
OF 


RC FROM CTTJ:OS FOR CTT200S 


REASON CODE FOR CTT200S 


OPERATJ:ON FOR CTT200S 


WORKEDJ:T DS 
CL256 
OPERATJ:ON FOR CTT200S 


SPACE 3 


*** 


* OUTPUT MESSAGES 


*** 


OUTDSN 


DSNAME 


OUTVOL 


VOLUME 


VOLMSG 


DSNMSG 


EOFMSG 


SCRJ:ND· 


*** 


DS 


ORG 


DC 


DS 


CL80' 


OUTDSN 


CL6' DSN= ' 


CL(L'DDSDSN) 


DATASET OUTPUT RECORD 


RECORD PREFiiX 


DATASET NAME 


DC 
CL(80+0UTDSN-*)' 'FJ:LLER 


ORG 


DS 


ORG 


DC 


DS 


CL80' 


OUTVOL· 


CL6' VOL= 
I 


CL(L'DVLVOLSR) 


VOLUME OUTPUT RECORD 


RECORD PREFJ:X 


VOLUME SERJ:AL 


DC 
CL(·SO+OUTVOL-*) I 
• FJ:LLER 


ORG 


DC 


DC 


CL80' *** VOLUME REPORT ***' 


CL80' *** DATASET REPORT ***' 


DC 
CL80•' *** END OF MDB WAS REACHED *** ' 


DC 
CL44' *** THJ:S J:S A SCRATCH VOLUME ***' 


SPACE 3 


* CTTI:OS J:N LJ:ST FORM 


*** 


J:OSLJ:ST 
CTTJ:OS MF=L 


SPACE 3 


*** 


* DATA CONTROL BLOCKS 


*** 


RPTVOL 


RP TD SN 


DCB 


DCB 


END 


DDNAME=DARPTVOL,MACRF=PM,LRECL=81,RECFM=FBA, 


DSORG=PS 


DDNAME=DARPTDSN,MACRF=PM,LRECL=81,RECFM=FBA, 


DSORG=PS 
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High Level API 


Calling programs that access the CONTROL-T Media Database via Basic Level API' must 
load a CONTROL-T Control Table and allocate the Media Database components .. High 
Level API' performs these actions automatically. 


High Level API' uses the Real-Time Environment TCT and the Real~Time Environment's 
Media Database components. 


As a result: 


• High Level API cannot be used when the CONTROI!.-T Real~Time Environment is not 
active. 


• Calling programs intended for use with High Level! API' have to be APF authorized~ 


CONTROL-T High Level API' is implemented by two Assembler macros: 


CTTACCDB 


CTTCHKDB 


Accesses the Medfa Database. 


Checks the last access o£the Media Database (via macro CTTACCDB). 


The following different functions can be performed by High Level API via macro 


CTTACCDB: 


START 


READ VOL 


ADDVOL 


DELVOL 


UPDTVOL 


END 


Initializes the High' Level APL. Access of the Media Database must begin: 
with this function. 


Reads a requested volume record fromi the Media Database. 


Adds a volume record to the Media Database. 


Deletes a volume record from the Media Database. 


Updates a volume record in the Media Database. 


Terminates the High, Level API' functions. Access of the Media Database 
must end with this function~. 


After each run 0£ macro CTTACCDB, it is highly recommended: to check the completion 
code of the access to the Media Database via macro CTTCHKDB. This macro tests the 
return, code fromi the API' and transfers control to an error handling routine which is 
written by the user as part of the calling program. 


Macro CTTACCDB 


As explained previously, High Level API' access to the Media Database is performed via 
macro CTTACCDB. 


Format 


Instructions for macro CTTACCDB are formatted as follows: 
label 
CTTACCDB 
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Parameters 


function-code 


buffer-address 


volser 


parms work-area 
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Function requested from macro CTTACCDB. Mandatory. This parameter 
must always be included as the first parameter. Valid values are: 


START 


END 


READ VOL 


ADDVOL 


DELVOL 


UPr>TVOL 


Perform initialization functions required to. enable access 
to the Media Database of CONTROL-T (e.g., gain access 
to the 
Real~Time Environment TCT, and open the 


Real~Time Environment Media Database). 


Perform cleanup functions after using High Level APT 
(e.g., close the Media Database). 


Read a volume record from the Media Database. A buffer- 
address, a volser, and a parms-work-ai::ea must be 
specified with this function code. 


Add' a volume record to· the Media Database. A 
buffer-address and a parms-work-area must be specified 
with this function code. 


Delete a volume record from the Media Database .. A 
volser and a parms-work-area must be specified with this 
function code. 


Update a volume record in the Media Database. A 


buffer-addi::ess and a parms-work-area must be specified 
with this function' code. 


Buffer used by macro CTTACCDB for either storing data retrieved' 
from the Media Database, or retrieving data to be inserted to the Media 
Database. This variable should point to an: area defined as follows: 


REC 
DS (DVLLEN)X 


This parameter is mandatory when function-code READVOL, ADDVOL 
or UPDTVOL is specified. 


Volume serial number. This variable should point to an area six 


characters in length. This variable is mandatory when function-code 


READVOL. or DEL VOL. is specified. 


Macro invocation work area; Mandatory. This variable should point to an, 
area defined as follows: 


ADBPARMS 
DS (ADBPLEN)X 


All invocations of CTTACCDB must access the same pai::ameter area. Therefore, you must 
use the same parms-work-area in all calls to macro CTTACCDB. 


Macro CTTACCDB must be coded in accordance with all standard macro Assembler 
coding restrictions. 


Values in general puvpose registers 0, 1, 14, and 15 are modified by macro CTTACCDB. 


Macro CTTACCDB accesses a set of variables generated by macro CTTADBP and by 
macro CTTDBTP. Therefore, the soui::ce of the calling program: should, include both these 
macros. 
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Macro CTTCHKDB 


This macro· is used to· check return codes resulting from access of the Media Database via 
macro CTTACCDB. 


Format 


Instructions for macro CTTCHKDB are formatted as follows: 
label 
CTTCHKDB 
ERR=error-routine, 


Where: 


error-routine 


work-a:rea 


PABMS=work-area 


Points to a subroutine in' the source code 0£ the calling program that 
handles errors in, accessing the Media Database. For more information 
see "Media Database Error Handling Routine" below. Mandatory. 


Invocation WOJ)k area of the last CTTACCDB macro. Mandatory. 


The value for this field must be· the same work area specified in the 
parameters for CTTACCDB. 


Macro CTTCHKDB must be coded in acco11dance with all standard: macro Assembler 
coding restrictions .. 


Values in.general purpose registens 0, 1and15 are modified by macro CTTCHKDB. 


Media Database Error Handling Routine 


The calling program must suppl:v an error handling routine. This error handling routine is 
given control wheneven macro CTTCHKDB determines that the last access to the Media 
Database was unsuccessful (e.g., the requested volume was not found). 


High Level API accesses a set of variables generated by macro CTTADBP. Some of these 
variables contain, relevant infol'mation on the Media Database erron handling routine.· The 
variables ane located in the area specified via parameter PARMS to macro CTTACCDB, 
and are mapped by macro CTTADBP. Below is a list o£these relevant variables: 


The High Level API invokes macro CTTIOS to access the Media Database. For more 
information see the description of macro CTTIOS ea:rlier in this section. 


ADBFRC 
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Return code from the last High Level API' function. Full' word. Possible 


values are: 


0 


8 


12 


16 


20 


24 


OK 


Invalid function requested' 


CONTROL-T TCT not found (i.e., CONTROI:.-T not active) 


A CTTlOS command failed (see pal'ameters ADBFIRC 


and ADBFIRSN described below) 


Internal error (CTTIOS handle not supplied) 


Media Database record not supplied 
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ADBPFUNC 


ADBPIRC 


ADBPIRSN 


ADBPIOPR 


28 


32 


36 
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Calling p:riogram is not APF authorized 


Key (volser) not supplied. 


Function, code is not allowed (denied by Exit CTTX006). 


Last CTTACCDB function. The field fo:ri this variable is eight characters 
long. 


Return code from the last run 0£ macro CTTIOS which was invoked by 
the High Level, API'. Full word. (For more details on the return codes of 
macro CTTIOS see the description 0£ message CTT200S in the IOA 


Messages and Codes Manual.) 


Reason code returned from the last run of macro CTTIOS invoked by the 
High Level API'. Full wo:rid~ (Fo:ri more details on the reason codes of the 
macro CTTIOS see the description of message CTT200S in the IOA 


Messages and Codes Manuah) 


Last CTTIOS function' issued by the High Level interface. This variable is 
contained in an 8-char:acter field~ 


Example for High Level API 


This sample access p:riogram reads the volume reco11d of volume VOOOOl from the Media 
Database using High, Level 
1 APl, and issues a message about the status of this volume (i.e., 


SCRATCH, ACTIVE, 011 NOT FOUND IN MDB). This sample also includes an example for 
the Media Database error handling routine. 


Note 
The code shown below is just an example and should not be used without appropriate 
modification. 


********************************************************************** 


* 
* 
* 
* 
* 
FUNCTJ:ON: 


* 
* 
* 
* 
* 
* 
* 
* 
* 
DD· CARDS: 


* 
* 


* 


CTTSAM2 
* 
* 
* 


SAMPLE PROGRAM TO DEMONSTRATE ACCESS TO THE CONTROL-T 
* 


MEDJ:A DATABASE 
(MDB) 
USJ:NG THE H:CGH LEVEL API. 
* 


THJ:S PROGRAM READS THE.MDB·VOLUME RECORD 1 0F A CERTAJ:N 
* 


VOLUME, 
(J:N THJ:S SAMPIIE: 
VOOOOl) AND ISSUES A MESSAGE * 


ABOUT THE VOLUME 'S · STATUS: 
ACTJ:VE OR SCRATCH. 


J:N TH:CS CODE.YOU WJ:LL ALSO FJ:ND 
1 AN EXAMPLE FOR AN 


MDB ERROR HANDLJ:NG ROU'J.'J:NE.THAT SHOULD 
1 BE CODED BY 


ANY CALLJ:NG PROGRAM THAT USES THE HJ:GH LEVEL APJ:. 


NONE 
(THE H:CGH LEVEL APJ: USES THE CONTROL-T REAL 


TJ:ME ENV:CRONMENT FJ:LES). 


* 
* 
* 
* 
* 
* 
* 
* 
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* 
D:CSCLA:CMER: 
TH:CS SAMPLE PROGRAM :CS PROVJ:DED·ON AN AS :CS BAS:CS1 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 


WJ:THOUT ANY WARRANTY, 
E:CTHER EXPRESS· OR :CMPLJ:ED 


REG:CSTERS: 
R13 


R4 


R9 


- 
BASE 


- 
MDB VOLUME RECORD 
(MAPPED BY CTTDVL) 


- 
CTTACCDB PARMS 
(MAPPED BY CTTADBP) 


ATTR:CBUTES: 
AMODE 31 


BMODE 24 


TO COMP:CLE AND L:CNK THE PROGRAM 


//CTTSAM2 JOB ••• 


//ASM 
EXEC CTTASM 


//C.SYS:CN DD DSN=:COA.V500.SAMPLE(CTTSAM2) 


//L.SYSLMOD DD D:CSP=SHR,DSN=YOUR.LOAD~L:CBRARY 


//L.SYS:CN 
DD* 


MODE BMODE(24) ,AMODE(31) 


NAME CTTSAM2(R) 
II* 


//RUN EXEC PGM=CTTSAM2, COND= ( 0 ., NE) , REG:CON=6 OM 


//STEPLJ:B· DD·D:CSP=SHR,DSN=YOUR.LOAD.L:CBRARY 


//DAMDB DD· D:CSP=SHR,DSN=CTT. VSOO•.MDBD 


//DAMD:C DD·D:CSP=SHR1DSN=CTT.VSOO.MDB:C 


//DATRC DD·D:CSP=SHR1DSN=CTT.VSOO.TRC 


//DARP'J!VOL DD SYSOUT=* 


//DARPTDSN DD SYSOUT=* 


II 


* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
* 
********************************************************************** 
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EJECT 
I 


CTTSAM2 
CSECT 
HIGH LEVEL API SAMPLE 


BEGIN *,EQUR=YES 


SPACE 1 


LA 
R9,ADBPARMS 
R9->> CTTADB·PARMS 
USING ADBP>R9 


xc 
FLAG, FLAG 
INIT INTERNAL FLAG 


SPACE 1 


********************************************************************* 
* 
PERFORM INTIALIZATION REQUIRED VIA HIGH LEVEL·API: START COMMAND* 


********************************************************************* 


SPACE 1 


CTTACCDB START,PARMS=ADBPA:RMS 
INITIALIZATION 


CTTCHKDB ERR=ADBERROR,PA:RMS=ADBPARMS 
CHECK START OPERATION 


SPACE 1 


OI 
FLAG, $OPENED· 
MARK: 
MOB IS OPENED 


SPACE 1 
********************************************************************* 


* 
READ MDB VOLUME RECORD OF VOLUME: 
V00001 VIA READVOL COMMAND 
* 
********************************************************************* 


SPACE 1 


MVC 
VOL(6),=CL6'V00001' 


SPACE 1 


VOLSER TO READ 


CTTACCDB READVOL,REC=VOLREC,VOL=VOL,PARMS=ADBPARMS 


CTTCHKDB ERR=RVOLERR,PA:RMS=ADBPA:RMS 


SPACE 1 


NI 
FLAG,X'FF'-$0PENED 
MARK: 
MOB IS NOT OPENED 


SPACE 1 
********************************************************************* 
* 
PERFORM CLEANUP REQUIRED VIA HIGH LEVEL API: 
END· COMMAND 
* 
********************************************************************* 


SPACE 1 


CTTACCDB END,PARMS=ADBPA:RMS 


CTTCHKDB ERR=ADBERROR1PA:RMS=ADBPARMS 


SPACE 1 
********************************************************************* 
* 
ISSUE A MESSAGE ACCORDING TO VOLUME'S STATUS: 
ACTIVE OR SCRATCH* 


********************************************************************* 


SPACE 1 


LA 
R4,VOLREC 
R4->>MDB VOL RECORD 


USING DVL,R4 


TM 
DVLSTAT,DVLSACT 
AN ACTIVE VOLUME ? 


BNO 
WTOSCR •• N, 
GO ISSUE: 
SCRATCH 


SPACE 1 


WTO 
'VOLUME VOOOOl IS ACTIVE' 
VOLUME IS ACTIVE 
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B 
EX:CT 


SPACE 1 


WTOSCR 
DS 
OH 
VOLUME :CS SCRATCH 


WTO 
'VOLUME V00001 :CS SCRATCH' 


SPACE 1 


B 
EX:CT 


DROP 
R4 
WAS MDB VOII RECORD 


SPACE 1 
********************************************************************* 
* 
MDB ERROR HANDLING ROU~:CNE - 
FOR READVOL FUNCT:CON 
* 
********************************************************************* 


RVOLERR 


SPACE 1 


DS 
OH 
READVOL ERROR 


L 
R15,ADBPRC 
R15 - 
CTTADB RC 
c 
R15,=F'16' 
A CTT:COS FA:CLURE ? 


BNE 
ADBERROR • .N, 
GO :CSSUE ERROR MSG 


SPACE 1 


L 
R15,ADBP:CRC 
R15 - 
RC OF CTT:COS 


c 
R15,=F'4' 
VOLUME NOT FOUND ? 


BNE 
ADBERROR· • .N, 
GO :CSSUE·ERROR MSG 


SPACE 1 


WTO 
'VOLUME V00001 NOT FOUND· :CN MEDJ:.A DATABASE' 


SPACE 1 


N:C 
FLAG,X'FF'-$0PENED 


CTTACCDB END,PARMS=ADBPARMS 
TRY TO PERFORM CLEANUP 


CTTCHKDB ERR=ADBERROR1PARMS=ADBPARMS 


SPACE 1 


B 
EX:CT 
NO OTHER UPDATES 


SPACE 1 


********************************************************************* 


* 
MOB.ERROR HANDL:CNG ROUT:CNE - 
FOR START/END FUNCT:CONS· 
* 
********************************************************************* 


ADBERROR DS 
OH 


MVC 
MSG1FUNC(8),ADBPFUNC 
CTTACCDB FUNCT:CON FOR MESSAGE 


MVC 
MSG1VOL(6),=CL6'V00001' VOIISER FOR MESSAGE 


L 
R3,ADBPRC 
CONVERT 


CVD 
R3, DW •• CTTACCDB 


UNPK 
MSG1RC(3),DW:+-6(2) •• RETURN-CODE 


O:C 
MSG1RC+2,X'F0' •• FOR MESSAGE 


SPACE 1 


MVC 
WT01+10(MSG1LEN),MSG1 
MOVE MESSAGE TO BE WTO'ED 


WT01 
WTO 


• I ROUTCDE=11 


MVC 
MSG2FUNC(8),ADBP:COPR 
LAST CTT:COS FUNCT:CON FOR MSG 


L 
R3,ADBP:CRC 
CONVERT 


+ 
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WT02 


EX:CT 


CVD 
R3,DW •• LAST CTT:COS 


UNPK 
MSG2RC(3),DW+6(2) 
o:c 
MSG2RC+2 Ix I FO ·1 


SPACE 1 


L 
R3,ADBP:CRSN 


CVD 
R3,DW •• LAST CTT:COS 


UNPK 
MSG2RSN(S),DW+5(3) 
o:c 
MSG2RSN+4 Ix I FO •• 


SPACE 1 


MVC 
WT02+10{MSG2LEN),MSG2 


WTO 


SPACE 1 


B 
EX:CT 


SPACE 1 


DS 


TM 


BNO 


OH 


FLAG,$0PENED 


SK:CPEND •• NI 


SPACE 1 


CTTACCDB END,PARMS=ADBPARMS 


SPACE 1 


SK:CPEND 
DS 
OH 


BRTRN 0 


SPACE 1 


RETURN-CODE 


FOR MESSAGE 


CONVERT 


REASON-CODE 


FOR MESSAGE 


MOVE MESSAGE TO BE WTO'ED 


I ,ROU'l'CDE=11 


:CS MDB ST:CLL OPENED· ? 


SK:CP END 


********************************************************************* 


* 
WORK AREAS 
* 
********************************************************************* 


DW 
DS 
D 
DOUBLE.WORD 


* 


FLAG 
DS 
x 
:CNTERNAL FLAG 


$OPENED 
EQU 
x•so• 
MARK: 
MDB :CS OPENED 


* 


MSGl 
DS 
oc 
lST ERROR MESSAGE 


DC 
C'CTTACCDB FUNCT:CON: 


MSGlFUNC DS 
CLS 


DC 
c• FOR VOLUME: 
'MSGlVOL 
DS 
CL6 


DC 
c• FA:CLED. 
RC: 


MSGlRC 
DS 
CL3 


MSGlLEN 
EQU 
*-MSGl 


* 


MSG2 
DS 
oc 
2ND ERROR MESSAGE 


DC 
C'LAST CTT:COS FUNCT:CON: 


MSG2FUNC DS 
CLS 


DC 
c• RC: 
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MSG2RC 
DS 
CL3 


DC 
c I REASON: 


MSG2RSN 
DS 


MSG2LEN 
EQU 


* 


VOL 


VOLREC 
* 


DS 


DS 


ADBPARMS• DS 


CLS 


*-MSG2 


CL6 


(DVLLEN)X 


(ADBPI:.EN)X 


VOLUME SER:J:AL NUMEBR TO READ 


MDB·RECORD BUFFER 


CTTACCDB WORK PARMS 


********************************************************************* 


* 
MAPP:CNG DSECTS 
* 
********************************************************************* 


END 
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Section 8: Maintaining IOA Products 


Introduction 


In IOA Release 5.0.0, maintenance is perfo!lmed through, SMP/E only, via PTFs containing object 
replacement elements. 


The following pa:ragraphs present a technical overview of the IOA Release 5.0.0 installation in 
order to facilitate the understanding of the maintenance processes. 


IOA Release 5.0.0 Packaging 


IOA Release 5.0.0 is packaged as a pre-installed SMP/E environment containing three SMP/E 
zones: GLOBAL, IOA5TZN (Target zone), and IOA5DZN (Distribution, zone). 


IOA Release 5.0.0 supporls use of any one ofthe following installation, modes for the SMP/E CST: 


• A new CSI file loaded with the GLOBAL, IOA5TZN and IOA5DZN zones. 


• An existing global zone for the IOA GLOBAL zone and two new CSI files, one fo:v the IOA5TZN 


zone and one for the IOA5DZN zone. 


• An existing CSI; file for aU three zones. The IOA GLOBAL zone is added to the existing global zone, 
while the IOA5TZN and IOA5DZN zones formi separate entities in the file. 
Product Packaging 


The pI1oducts in IOA Release 5.0.0 are packaged as different functional components as listed in 
the following table .. IOA is the base component for all products. 


Table 1: IOA Release 5.0~0 Functional Components 


IOA5000 


IOA500C 


CTM5000 


CTD5000 


CTD500C 


CTR5000· 


CT05000 


CTB5000 


CTB500C 


CTW5000 


CTW500C 


CTV5000 


CTT5000 


IOA Release 5.0.0 Common Routines, Samples, etc. 


IOA Release 5.0.0 C Language Modules 


CONTROI:.-M Release 5.0,0 Modules and Samples 


CONTROL-D Release 5.0.0 Modules and Samples 


CONTROL-D Release 5;0.0 C Language Modules 


CONTROL-R Release 5.0.0 Modules and Samples 


CONTROL-0 Release 5.0.0 Modules and Samples 


CONTROL-B Release 5.0.0 Modules and Samples 


CONTROL-B Release 5.0.0 C Language Modules 


MVS Gateway for Enterp11ise Controlstation 
Release 5.0.0 Modules and Samples 


MVS Gateway for Enterprise Controlstation 
Release 5.0.0 C Language Modules 


CONTROL-V Release 5.0.0 Modules and Samples 


CONTROL-T Release 5.0;0 Modules and Samples 
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Language Support 


IOA Release 5.0.0 suppol.'ts various languages. Program elements fol' each language are packaged 
as unique functions in IOA Release 5.0~0 as follows: 


Table 2: Language Elements 


IOA500F 
IOA Release 5.0.0 French Elements 


IOA500G 
IOA Release 5.0.0 German Elements 


IOA500J 
IOA Release 5.0.0 Japanese Elements 


A different SMP/E environment exists fol' each language supported by IOA Release 5.0.0. Each 
environment contains the IOA Release 5.0.0 functions listed in, Table 1 above, as well as the 
appropriate language function (applied and accepted). Each language function contains a LOAD 
libl'a11y in which the load modules which suppovt the language in question are sto11ed. These load 
modules, as well as screen and message source members, are named accovding to the language 
they support (e.g., GEMMABC is the name of the message member for ABC). 


This naming convention enables SMP/E to support the lib11ar:ies of; the basic English installation 
as well as the librar:ies of the language suppol.'t installatiom However, it prevents maintenance 


u 


from identifying the modules that should be updated. The following example demonstrates 
'U' 


aliases that are utilized to overcome this problem~ 


The example in the table below compares the linking of; comparable English and German load 
modules (containing the same functionality). In the example, the English load module is linked 
into the IOA LOAD lib11ary while the German NLS load module is linked into the LOADGER 


library. 


Table 3: Example 


ORDER CTMABC 
ORDER CTMABC 
NonNLSMOD 


ORDER CTMMABC 
ORDER GEMMABC 
Language sensitive MOD 


INCLUDE (CTMABC) 
INCLUDE (CTMABC) 


INCLUDE (CTMMABC) 
INCLUDE (GEMMABC) 


NAME CTMABC(R) 
ALIAS CTMABQ 


NAME GEMABC(R) 


LOAD 
LOAD GER 
SYSLMOD name 
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Applying Periodic Maintenance 


Periodic maintenance is applied via the Installation and Customization· Engine (ICE). 


Perform the following preliminary steps and installation steps to apply periodic maintenance .. 


Preliminary Steps 


1. Load the maintenance tape files to the BASE.MAINT library. 


2. Refer to the IOA Installation Guide for instructions on how to invoke and use ICE. 


3: Invoke ICE and verify that "IOA" is specified in the "Product ID" field, and that "YES" is specified 
in the "Enforce Step• Order" field~ 


4. Select option' 4 (Maintenance) on the ICE menu, Major steps for installing maintenance are then 


displayed, 


5. Apply the major steps listed below. 


Installation Steps 


Step 1 
Apply Periodic Maintenance 


Select major step 1 "Appl!Y Periodic Maintenance." The Minor Steps Selection screen is displayed. 
0 
Step 1.1 
Specify Maintenance Level 


Select minor step 1 "Specify Maintenance Leveli". 


In the Maintenance Level Specification screen, specify the maintenance to be applied in the 
format yynn; and specify YES in the "Do you want to. reset the steps status?" field. 


Exit the Maintenance Level• Specification 
1 screen. 


Mark this step as completed .. 


0 
Step 1.2 
View Maintenance Documentation (Optional) 


If written documentation is available view it. This step. is optional. 


Follow the steps specified in the documentation to apply the maintenance. 
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Applying Ad Hoc Maintenance 


Introduction 


Fixes to IOA Release 5.0.0 are applied using SMP/E. (The Installation and Customirzation Engine 
is not used to apply Ad. Hoc Maintenance.) 


Once a fix is applied by SMP/E, the affected elements which reside in base libraries (e.g., source 
members, the JCL, samples) often: contain unresolved installation: vadables and are likely to 
require further tailoring. These elements must be p:riopagated (i.e., copied and tailored) to the 
working libraries. Other elements, such as load modules, are applied by SMP/E directly to the 
working libraries and do not require any further processing. 


The following steps describe how to instaU the fix in: the active environment. 


Installation Steps 


Step 1 Run SMP/E to RECEIVE, APPLY CHECK and 
APPLY the Fix 


LOAD the fixes into your IOA MAINTLIB library. It is recommended that you use the same name 
for the member as the fix name. 


Example 


Fb~ 


Where: 


"p" 
Product ID 


"nnnnnl' 
Fix number (e.g., Fll2345) 


Run an' SMP/E job using the supplied IOASMP procedure to: 


• RECEIVE the fixes into your SMP/E CSl file which, contains IOA Release 5.0.0. 


• APPLY CHECK the fixes for detection: of errors (e.g., missing prerequisite fixes). 


Note 
Procedure IOASMP is used in examples throughout this section. However, if installation 
parameter PROCPREFA was changed in ICE from its supplied default, the procedure name 
should be modified accordingly; This also applies to other JCL procedures which are execute& 


Similarly, the target zone that is indicated in the sample job. below is the default zone name 
IOA5TZN. If ins_t'iillation parameter IOATZN was 7nodified in ICE, the modified value should 
be used instead~ · 
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The following is a sample JCL for an SMP/E RECEIVE and APPLY CHECK job: 


llSMPJOB JOB ,•your job-card•, ••••• 
I ISMPSTEP 
EXEC J:OASMP 
llSMPPTFJ:N 
DD 
DJ:SP=SHR,DSN=J:OA.VSOOBASE.MAJ:NTLJ:B(FJ:12345) 
II 
DD 
DISP=SHR,DSN=J:OA.VSOOBASE.MAINTLZB(FMnmmn) 


llSMPCNTL 
DD 
* 


I* 


SET BDY(GLOBAL). 
RECEJ:VE SYSMODS LJ:ST. 
SET BDY(J:OASTZN). 


APPLY S(FJ:12345, FMnmmn, ••••• ) CHECK. 


Befo11e applying a fix:, verify its SMP/E HOLD status. A fix may be in HOLD status due to an 
error or an action that must be performed. The output of the SMP/E RECEIVE SYSMODS LIST 


lists any HOLDDATA associated with the fixes that were received. 


If the current fix being applied is in, HOLD status, the HOLDDATA indicates the reason. If the 
reason is ACTION, a comment describes the steps to be taken, p11ior to or following the APPI:.Y of 
the fix. Ensure that these instructions are carefully followed. 


If the fix is held, the APPLY CHECK fails and displays an informational message .. If you have 
reviewed the HOLDDATA and know which actions are required, you can add the keyword 


BYPASS(HOI:.DSYS) to the APPLY CHECK statement and rerun, it. If, however, the reason for 
the hold is ERROR, the fix should not be applied until a corrective fix is available. 


The following is a sample SMP/E APPLY CHECK job with the bypass for the HOLD status: 


llSMPJOB 
JOB 
,•your job-card', ••••• 
I I SMPSTEP · 
EXEC 
IOASMP · 
llSMPCNTL 
DD 
* 


SET BDY(J:OASTZN). 


APPLY S(FJ:12345) BYPASS(HOLDSYS) CHECK. 


I* 


When the APPLY CHECK completes successfully, the CHECK keyword should be removed and 
the APPEY should be run to· install the fix in, the I OA target environment. 


0 Step2 
Customize and Propagate Fix Elements to 
Working Libraries 


Perform this step only if a fix that was applied in Step 1 is on HOLD with an, ACTION reason 
that requires tailoring and propagation. 


Applicable fixes are those which modify elements (PDS members) in base libraries, which may 
require file tailo11ing and are likely to contain unresolved vaviables (e.g., parameter ILPREFA). 
Two IOA utilities, IOAFTR and IOAINS, are run for these fix elements. Note that fixes to load 
modules are always applied, directly to the active environment. 
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During propagation, all elements applied by a single SMP/E APPLY command should be 
'0 


propagated at the same time·to·verify that all prerequisite and corequisite fixes are applied to the 
working environments. To determine which elements require propagation, and the appropriate 
action, review the Element Summary repo11t in the SMPRPT dataset (pvoduced by SMP/E APPLY) 


and' follow the rules below: 


Elements that meet any of the following criteria do· not require propagation: 


• Elements with an entry in the LMOD SYSL.IB column, except user and security exits. 


• Elements with one of the following listed in the SYSL..IB library columm MAC, MSG, PANEL, 
ISMSG, CICSSAMP, SAMPREPS, BANNERS, CAL. 


• Elements that al'e part of ICE (i.e., element whose names beginning with IOAI and that have a 


SYSLIB lib11ary specification1ofINSTALL). 


• Elements with a SYSL.IB library of GENERAL. Fo11 these elements, a different procedure, described 
later in this section~ is required. 


The following sample Element Summary report sample shows two elements that require 
propagation: CONTROLM (in the IOA PROCLIB lib11ary), and $PROFFLD (in the IOA PARM 


library). Elements CTDSEC, CTMCUSl and IOAHLP do not require pvopagation as they all have 
entries listed in' the LMOD SYSLIB column •. $$FRM does not require propagation as its SYSLIB 


library is MSG, and IOAICHLP is part of ICE (i.e., starts with IOAI and has INSTALL listed in 
the SYSLIB library column~. 


ELEMENT SUMMARY REPORT FOR APPLY CHECK PROCESS:CNG 


ELEMENT 
ELEMENT 
ELEMENT 
CURRENT CURRENT Dl:STL:CB 
SYSL:CB 
ASSEM 
SYSMOD 
SYSMOD 


TYPE 
NAME. 
STATUS 
FM:CD 
RM:CD 
L:CBRARY 
L:CBRARY 
NAMES 
NAME 
STATUS 


MAC 
APPL:CED 
CONTROLM APPL:CED 
:COASOOO F:C00075 APROCL:CB PROCL:CB 


LOAD 
LMOD 


MODULE 
SYSL:CB 


F:C00075 


SRC 
CTDSDEC 
APPL:CED 
:COAS000 1 F:C00071 AMSG 
MSG 
CTDSDEC 
CTDTAMS 
LOAD 
F:C00071 APPLIED 


MOD 
CTMCUS:C 
APPL:CED 
:COASOOO• FJ:000!72 A:COALOAD 
F:C000'72 APPL:CED 


MOD 
IOAHLP 
APPL:CED 
:COA5000 1 FI00030 1 A:COALOAD 
FIOOOBO•APPL:CED 


HELPENP 
$$FRM 
APPL:CED 
APPL:CED 
:COA5000 F:C00073 AMSG 


PARM 
APPLJ:ED 
$PROFFLD APPLIED 
:COA5000• F:C00083 APARM 


MSG 


PARM 


CTMC:CNT 
LOAD 


CTMCTSO 
LOAD· 


:COAHI.IP 
:CNSL 


F:C00073 


F:C00083 


SAMP 
APPL:CED 
:COA:CCHLPAPPL:CED 
:COASOOO F:C00030'A:CNSTALL :CNSTALL 
F:C00030 


To propagate the required elements, edit member IOAPROPJ. in the IOA INSTALL library. This 
member copies and tailors the members that were updated or replaced by the fix from the base 


libra11ies into the environment libraries. 
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The default IOAPROPJ member is presented below: 


ll'MYJOBJOB •my job card', •••• 


II*======================================== 


I I* PERFGRM: 
II* 
CHANGE '????????' 'member-name• ALL 


II* 
CIDUlGE ·~· •library suffix• ALL 
II*======================================== 
llPROP1 
EXEC IGAPRGP, 
II 
II 


BASEPRF=IOASO 0 '·BASE, 


ILPREFA=IOASO 0 '• 'l'ES'l':C 


llIOAF'l'R.SYSIN DD * 


COPY INDD=I~,OU'l'DD=O@@@@@@@ 


<===== Specify YGUR BASEPRF 


<===== Specify YGUR ILPREFA 


<===== Input cards to IOAF'l'R 


SELEC'l' MEM=????????,REPLACE=YES<===== Input cards to IOAF'l'R 


I* 
llIOAINS.DALJ:BS 
DD * 
*---+----1----+----2----+----3----+----4----+ 
???????? IOASOO'.'l'ES'l'I.@@@@@@@ 
I* 


<===== Input cards to IOAINS 


Change the· member name that was changed ov replaced and the last qualifier (suffix) of the 
library in accordance with the value listed in the SYSLIB library column for that element .. For 
example, if member CONTROLD was replaced in the PROCLIB lib:riary, the JCL will appear as 
follows: 


ll'MYJOB JOB •my job card', •••• 


II*======================================== 


II* PERFORM: 


II* 
CHANGE '????????' 'member-name• ALL 


II* 
CHANGE '@@@@@@@' 'library suffix• ALL 
II*======================================== 


llPROP1 
EXEC IOAPROP, 


II 
II 


BASEPRF=IOAS 0 0 •.BASE, 


ILPREFA=IOASOO.'l'ES'l'I 


llIOAF'l'R.SYSIN DD * 


COPY INDD=IPROCLIB>OUTDD=OPROCLJ:B 


<===== Specify YOUR BASEPRF 


<===== Specify YOUR ILPREFA 


<===== :tnput cards to IGAF'l'R 


SELEC'l' MEM=CON'l'ROLD,REPLACE=YES<===== Input cards to IOAF'l'R 
I* 
llIGAINS.DALIBS 
DD * 


*---+----1----+----2----+----3~---+----4----+ 


CON'l'ROLD IOAS 00 '• 'l'ES'l'I. PROCL:CB 
I* 
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If more than one member or move than one library is changed by the fix, you can repeat the 
\..-/ 


control' cards of both utilities as necessary. Fo11 example, the following is a sample job that 


p11opagates members CONTROLM and CONTROLD in the PROCLIB library, and member 


$PROFFLD in the PARM library: 


llM'IJOB JOB •my job, card', •••• 


II*======================================== 


II* PERFORM: 


II* 
CHANGE '????????' 'member-name• ALL 


I I* 
CHANGE '@@@@@@@' 'library suffix' ALL. 
II*======================================== 
llPROP1 
EXEC J:OAPROP, 
II 


II 


BASEPRF=J:OASOO.BASE, 


J:LPREFA=J:OASOO.'l'ES'l'J: 


I /J:OAF'l'R. SYSJ:N DD * 


COPY J:NDD=l:PROCLJ:B,OU'l'DD=OPROCLJ:B 


<===== Specify YOUR BASEPRF 


<===== Specify YOUR J:LPREFA 


<===== J:nput cards to J:OAF'l'R 


SELEC'l' MEM=CONTROLM,REPLACE=YES<===== J:nput cards to J:OAF'l'R 


SELEC'l' MEM=CONTROLD,REPLACE=YES<===== J:nput cards to J:OAF'l'R 


COPY J:NDD=J:PARM,OU'l'DD=OPARM 
<===== J:nput cards to J:OAF'l'R 


SELEC'l' MEM=$PROFFLD,REPLACE=YES <===== J:nput cards to J:OAF'l'R 


I* 


llJ:OAJ:NS.DALJ:BS 
DD * 
*---+----1----+----2----+----3----+----4----+ 


CONTROLM J:OASOO.'l'ES'l'J:.PROCLJ:B 


CONTROLD J:OASO 0 '• 'l'ES'l'J:. PROCLJ:B 


$PROFFLD :rOASO 0 '• 'l'ES'l'J:. PARM 


I* 


<===== J:nput cards to J:OAJ:NS 


<===== J:nput cards to J:OAJ:NS 


<===== J:nput cards to J:OAJ:NS 


After performing the necessary customization', submit the job~ All' steps must end, with a condition 
code of O. 


Processing Elements with a SYSLIB Library of GENERAL 


Elements that have a SYSLIB lib11ary of GENERAL should be processed according to the 
following rules: 


• Elements belonging to non-installed products require no.further processing~ 


• Elements belonging to installed p11oducts must be copied manually to the product libr:ary as 
directed by the HOL.D action of SMP/E .. The element may contain' unresolved installation variables. 
Therefore, utility IOA,INS should be run to resolve them, To run, utility IOAINS, modicy job 


IOAINSJ in1 the IOA INSTALL lib11ary (as described below). 
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The default IOAINSJ, member is presented below: 


//M'.lJOB.JOB •my job card', •••• 


//**************************************************************** 


II* 
PLEASE MAKE THE FOLLOWJ:NG CHANGES: 
* 


II* 
CHANGE '????????' 'MEMBER-NAME' ALL 
* 
//* 
CHANGE '@@@@@@@@' 
'J!'ULLY-QUALJ:FJ:ED-LJ:BRARY-NAME' 
* 


II* 
CHANGE '&&&' 
1 3-CHABACTER•PRODUCT-J:D' ALL 
(E.G. 1CTM 1 ) 
* 


II* 
CHANGE 
1 # 1 
'1-CHABACTER•PRODUCT-J:D' 
(E.G. 'M') 
* 
//**************************************************************** 


//CTMJ:NST 
EXEC PGM=J:OAJ:NS,PARM='&&&', 
II 
REGJ:ON=5120K,TJ:ME=30· 
//STEPLJ:B 
DD DJ:SP=SHR1DSN=%BASEPREF%.J:NSLOAD 


//SYSPRINT DD SYSOUT=* 


//PRTDBG 
DD DUMMY 


//SYSUDUMP·DD·SYSOUT=* 


DD DJ:SP=SHR1DSN=&J:LPREFA%.J:NSTALL(DEFPAEIMA) 


<=== Check Parm 


//DAREP 


II 
DD DJ:·SP=SHR1DSN=&J:LPREFA%.J:NST&&&(DEFPARM#) 
<=== Check library/member 


//DALJ:BS 
DD 


* IOAJ:NS J:NPUT STATEMENTS 


*---+----1----+----2----+----3----+----4----+ 


? ?? ?? ? ? ? @@@@@@@@ 


/* 


Change the member as follows: 


<== IOAJ:NS CONTROL CARDS 


• Replace ???????? with the member name from the ELEMENT NAME column. 


• Replace @@@@g@@@ with the fully-qualified dataset name. The SMP/E HOI:.D data will contain 
the library suffix. 


• Replace &&& with the thllee-character product ID from the SMP/E HOLD data to·specify the value 
in the PARM field· and the name of the product installation library. 


• Replace# with the one-character product ID from theSMP/E HOI:.D data to resolve the name of the 


DEFPARMx member in, the p:rioduct installation, library. 


• If the product is CONTROL-R, repeat the second, DAREP line and modify it so that it points to 
member DEFPARMM in, the IOA INSTCTM library. 


• If the product is CONTROL.-V, repeat the second' DAREP line and modify it so that it points to 
member DEFPARMD in, the IOA INSTCTD lib:riary. 


IOAINS control cards may be repeated in the same IOAINS step. for elements belonging to the 
same product. 
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The follt>wing sample shows IOAINSJ tailored to p:vocess this member:: 


llflr.IJOB JOB •my job card', •••• 


II**************************************************************** 


II* 
PLEASE MAKE THE.FOLLOWING CHANGES: 
* 


II* 
CHANGE '????????' I MEMBER ... NAME I ALL· 
* 


II* 
CHANGE 
•@@@@@@@@.·• 
'FUIILY-QUALIFIED-L:CBRARY-NAME' 
* 


II* 
CHANGE 
I&:&:&: I 
'3-CHARACTER,..PRODUCT-ID' ALL· 
(E.G. 'CTM') * 


II* 
CHANGE .,. 
'1-CHARACTER-PRODUCT-ID' 
(E.G~ 'M') 
* 
II**************************************************************** 


llCTMINST 
EXEC PGM=IOAINS,PARM='CTR', 
<=== Check Parm 


11 
REGION=5120K,T::cME=30 
1 


llSTEPil:CB 
DD D:CSP=SHR•DSN=your.basepref.INSIIOAD 


llSYSPRINT DD SYSOUT=* 


llPRTDBG 
DD DUMMY 


llSYSUDUMP DD SYSOUT=* 


DD· DISP=SHR1 DSN=your. ilprefa. INSTALL (DEFPABMA). 
llDAREP 


II 
II 
llDAL:CBS 


DD D:CSP=SHR,DSN=your.ilprefa.:CNSTCTR(DEFPARMR) <== for CONTROL-R 


DDD:CSP=SHR,DSN=your.ilprefa.INS'l'CTM(DEFPABMM)' <==for CONTROL-M 


DD 


* IOAINS INPUT STATEMENTS 


*---+----1----+----2""---+----3----+----4----+ 


C'l'RCNPJ your.ilprefr.JCL 


I* 


<== :CNPUT CARDS TO :COA:CNS 


Submit the job; All steps must end withi a condition code 0£ 0: 


Step3 
Enable Fixes Applied to ICE 


If a fix results in1 the replacement of ICE tables, the new copy o:D the table must be merged with 
all values p11eviously entered during installation1 customization1 etc; 


Performi this step only if the fix was held in SMP/E with reason ACTION, and the hold comment 
refers specifically to. enabling I CE fixes. 


After applying the fix, enter ICE and choose the Housekeeping activity fromi the ICE Main menu. 
Select "Refresh Tables" to refresh the ICE elements that were replaced by the fix .. 
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Step 4 Copy JCL Procedures and ISPFElements to 


System Libraries (Optional) 


If a fix replaces JCL p11ocedures, CLISTs or ISPF elements which were copied to system libl'aries 
during installation, these elements need to be recopied. 


Perform this step only if the fix was held with reason ACTION, and the hold comment specifically 
refers to,copying JCL p11ocedures and ISPF elements to system libl'al'ies. 


Skip this step if JCL p11ocedures and ISPF elements are not copied during installation, to your 
system libraries. 


If you chose to copy JCL procedures to your system PROCLIB (i.e., installation parameter 


PROCLIB contains a value other than DONTCOPY), any updated p11ocedures should be recopied. 
If the value of installation parameter PROCPREFA was modified and does not use the default 
value of IOA, the procedures should be copied with a new name that matches the value specified. 


forPROCPREFA. 


If you choose to. copy CLISTs 011 ISPF messages, panels, skeletons or tables to your system 
libraries, (i.e., a value other than· DONTCOPY was specified fo11 installation parameters CLIST, 
ISPFMSG, ISPFPNL, ISPFSKL, or ISPFTBL), updated elements should be recopied .. 
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Section 9: Utilities 


General 


This section describes the administrative utilities available fo11 each IOA pl'oduct. 


A summary of these utilities (by p11oduct) is p11ovided below. This section contains a 
detailed description of each utility (in alphabetical order by product). 


Summary of Utilities 


The following list p11ovides a sho11t description of each utility used in the IOA environment. 
These utilities are fully described later in this section unless othe11wise noted. 


Note 
Some utilities prefixed by JOA replace corresponding utilities prefixed by CTM, CTD, 
and! or CTB in previous releases. In such cases, the old utilities are supported for your 
convenience; however, we recommend using the JOA utilities. 


IOA Utilities 


IOABLCAL 


IOACLRES 


IOACND 


IOACOPRS 


IOACP~OG 


IOAFRLOG 


IOAFRNRS 


IOAFRRES 


IOALDNRS 


IO ATE ST 


IOAVCND 


IOAVERFY 


Builds calendars. 


Cleans the IOA Conditions/Resources file. 


Perform Condition/Resource Adjustments. 


Copies, or changes the size of, the IOA Conditions/Resources file. 


Copies contents of the IOA Log file to a sequential file or to another 
Log file. 


Allocates and fo11mats an IOA Log file (used during IOA installation). 


Allocates and formats an IOA Manual 
1 Conditions file (used during 


IOA installation). 


Allocates and fo11mats an IOA Conditions/Resources file (used. during 


IOA installation). 


Loads/creates the IOA Manual Conditions list. 


Simulates various events in the IOA environment. 


For VM/CMS environments. Sets pre11equisite conditions in a 


CONTROI:.-M monitor running on an NJE-connected MVS machine. 
(See the description of utility IOACND in this section, of the manual.) 


Verifies installation' and produces reports on the status of various IOA 


files. 
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CONTROL-M Utilities 


Note 
Unless otherwise noted, all CONTROL-M utilities are described in the CONTROL-M 


User Manual. 


CTMAESIM 


CTMBGRP 


CTMBLDAE 


CTMBLT 


CTMCAJF 


CTMFRCKP 


CTMJSA 


CTMRCAL 


CTMRELRS 


CTMSIM 


Tests the syntax 0£ AutoEdit control' statements. 


Converts regular scheduling tables to group scheduling tables 
(described later in, this section). 


Builds an1 AutoEdit symbol member using a CONTROL-M calendar as 
input. 


Creates CONTROL-M Scheduling tables. 


Compresses or changes the size 0£ the CONTROL-M Active Jobs file 
(described later in this section~. 


Allocates and, formats a CONTROL-M Active Jobs file (used during 


CONTROL-M installation). 


Accumulates job statistical data in the CONTROL-MJob.Statistics file 
(described later in this section). 


Creates a calendar for each job defined in CONTROL-M showing the 
actual execution date(s) 0£ the job: 


Releases Quantitative resources from ajob step; 


Activates the Simulation and Forecasting facility. 


CONTROL-DN Utilities 


CTDAMUTI 


CTDCAMF 


CTDCATF 


CTDCA2P 


CTDCCU 


CTDCLHIS 


CTDCP2A 
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Copies, moves and 1 deletes CDAM files (described in Section 5 0£ the 


CONTROL-D User Manual). 


Compresses or changes the size o£the Active Missions file. 


Compresses or changes the size 0£ the Active Transfer file. 


Copies new report/user entries from the Active User Repol't List file to 
the Permanent User Report List file. 


Identifies CDAM files not referenced by the Active User Report List 
file and optionally deletes them1 


Erases backup tapes which have expired based on parameter # OF 
DAYS TO KEEP specified in, the Backup Mission Definition screen'. 


Copies empty report/user entries from the Permanent User Report 
List file to the Active User Report List file. 
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CTDDELRP 


CTDDIB 


CTDFRCOM 


CTDSMFRP 


CTDUPBKP 


CTVCLMIG 


CTVDELl 
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Moves report entries from the Active to the Migrated and/or History 


Repol't List file and erases their compvessed datasets from DASD 


storage. 


Rebuilds a CONTROL-D User Report List file's index component. 


Allocates and formats a Communication1 file. 


Produces a paper CONTROL-usage report (described in1 Section 6 of 
the CONTROL-D User Manual). 


Updates Backup infovmation. in the User Report List files 
(Active/Migrated/History/Permanent). 


Cleans entries from the Migrated User Report List file and erases 011 


uncatalogs their CDAM datasets. 


Deletes unneeded index files from disk based on user-specified 


selection groups. 


IOA Access Method Utilities (for User Report List Files) 


IOADBF 


IOADBSR 


IOADCPY 


IOADIG 


IOADH 


IOADLD 


IO AD PT 


IOAD"C!JL 


Fol'mats a CONTROL-D User Report file's index OI' data component. 


Sorts and reo11ganirzes a CONTROL-D User Repo11t file's data 
component. 


Restores a CONTROL-D User Report file from a dual mirror image 
copy. 


Verifies the integrity of a CONTROL-D User Repo11t file's data 
component. 


Verifies the integrity ofi a CONTROL-D User Report file's index 


component. 


Loads a CONTROL-D User Report file's index or data component 
contents from a sequential dataset. 


Prints a CONTROL-D User Report file's data and index component 
records in SNAP dump format. 


Unloads .a CONTROL-D User Repo11t file's index or data component 
contents to a sequential dataset. 


CONTROL-0 Utilities 


CTOALOCP 


CT08SF 


CTORSTM 


Backs up the Automation Log. 


Copies the Message Statistics file. 


Produces repovts on message statistics .. 
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CONTROL-B Utilities 


CONTROL-B Group and Variable File Handling Utilities 


CTBDBVCP 


CTBDBVDL 


CTBDBVIG 


CTBDBVCG 


Copies a specified variable 011 group of: va11iables to another set of: 


variable/group files. 


Deletes a valliable or a group of variables from variable/group files. 


Checks the integrity of variable/group data files. 


Changes the number of generations of a Database Variable. 


CONTROL-B Report and Rule Activity File Handling Utilities 


CTBJAFCP 


CTBJAFDL 


CTBJAFIG 


Copies invocation: and report entries to other Rule Activity and Report 
files. 


Deletes unnecessary entries from the Rule Activity and Repo11t files. 


Checks the integrity of Rule Activity and Repo11t data files .. 


CONTROL-B Active Balancing File Utilities 


CTBABI 


CTBFRM 


Initializes the Active Balancing file after creation. 


Compresses the Active Balancing file (usually on a daily basis as pa11t 


of the New Day procedure). 


IOA Access Method File Utilities 


CTBDBIB 


IOADBF 


IOADIG 


IOADII 


IOADPT 


IOAD0PY 


Rebuilds the indexes of specified CONTROL-B data files. 


Allocates and Fo11mats an IOA Access Method file's data or index 
component. 


Verifies the integrity of an' IOA Access Method file's data component. 


Verifies the integrity of an, IOA Access Method file's index component. 


Prints an IOA Access Method file's data and index component reco11ds 


in SNAP dump fo11mat. 


Restores an IOA Access Method file from a dual mirror image copy. 


Miscellaneous.Utilities 


CTBVXRF 
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Produces a repo11t indicating which valliables are used by which rules, 
(described in Section 8 of the CONTROL-B User ManuaH. 
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CONTROL-T Utilities 


Trace Utilities 


CTTACP 


CTTAFR 


CTTCTRC 


CTTTRB 


Stacking Utilities 


CTTGVL 


CTTSTK 


Copies the Trace file. 


Fo11mats and initializes the Trace file. 


Allocates and formats the Trace file. 


Synchronizes the Trace file and the Media Database backup p11ocess .. 


Provides a user interface to the Stacking Facility. 


Builds and updates the Stacking Statistics file. 


Media Database Utilities 


CTTBIX 


CTTDLD 


CTTIDB 


CTTMER 


CTTMUP 


CTTRCV 


CTTSPIJ 


CTTUDB 


Rebuilds the index ofi the Media Database. 


Adds non-scratch volumes, adds and deletes scratch volumes, and' 
converts from1 othe11 tape management systems. 


Checks the integrity of the Media Database. 


Merges reco11ds from an extract file (created. by utility CTTSPL) into 
the Media Database. 


Perfo11ms manual update of the Media Database. 


Recovers Media Database contents using the Trace file. 


Copies or moves (Splits) specified records fromi the Media Database. 


Updates Media Database records fromi a transaction file (which is 
created by utility CTTIDB). 


Daily Management Utilities 


CTTRTM 


CTTVTM 


Performs retention management. 


Perfoi;ms vault management. 
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Database Handling Utilities (for the Media Database and Stacking Statistics File) 


CTTCRDF 


CTTDBDLD 


CTTDBDUL 


CTTDBF 


CTTDBIB 


CTTDBlD 


CTTDBII 


CTTDBPRT 


Allocates and formats various data and/or index files. 


Loads Media Database and Stacking Statistics file data components 


fromi a sequential dataset. 


Unloads Media Database and Stacking Statistics file components to a 
sequential dataset. 


Formats existing data and/or index files. 


Rebuilds the indexes of the Stacking Statistics file. 


Checks the integrity of a data file. 


Checks the integrity of an index file. 


Prints (in dump format) records fromi a database file to a sysout. 


Miscellaneous CONTROL-T Utilities 


CTTRPT 


CTTTPI 
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Generates reports and fromi extracted, Media Database info11mation, 


Initializes tapes, erases tapes, and produces a detailed report of the 
logical and physical contents of a volume. 
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IOA Utilities 


IOABLCAL - Build Calendars 


The scheduling of jobs, missions and rules in the IOA environment is frequently based on 
calendars. A data center may use different calendars for different scheduling 
requirements. For example: 


WORKDAYS 


HOLIDAYS 


ENDOFMON 


NOTEOFMN 


All w011king days in, the year 


All non-standard holidays 


Business end-of~month scheduling 


All wor:king days except end-of~month days 


In many cases, a calendar is related to, and can be derived' from, a different calendar or 


from a combination of two different calendars. For example, in the calendars listed above, 
calendar NOTEOFMN can be derived from a combination of calendars WORKDAYS and 


ENDOFMON. 


When calendars are related, a change to one calendar frequently affects other calendar:s. 


This can make manual maintenance of calendars time-consuming and error-prone. Utility 


IOABLCAL simplifies and automates calendar maintenance. 


Th11ough parameters supplied to the utility, the user specifies two existing calendars and 
the operation' (or formula) which determines how the calendars are combined to build a 
new calendar:. 


The new calendar created by the utility is a regular calendar:. It can be viewed using 


Option 8 (Calendars) of the IOA Primary Option Menu and it can1 be used as an1 input 
calendar in' subsequent runs of the utility. Thus, using several basic calendars, numerous 
other calendars can be created. 


It is recommended that all steps which calculate calendars be collected into one job, and 
that the job be run once a day. This will refresh the calendars in the event that changes 
are made to the basic calendars. 


Parameters 


Parameters are supplied to the utility either via DD statement DABCLIN (or: SYSIN) or 
via PARM .. Any number of parameter statements may be specified. Parameter statement 
syntax is: 
calendarl operator calendar2 = calendar3 
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Where: 


calendar!, calendar2 Input calendars. 


operator: 
One of the following operators: 


+, -, *, <W nn, >W nn, <> W, >< W 


calendar3 
Resulting calendar. 


If the operation is +, calendar3 will contain all days marked Y in calendar! and 
additionally all days marked Y in' calendar2~ 


If the operation is -, calendar3 will contain, all days marked Yin calendar! excluding those 
days marked Yin calendar2~ 


If the operation is *, calendar3 wiU contain, all days marked Yin' calendar! which are also 
marked Yin, calendar2. The day has to be marked for execution in both calendars to be 
marked in calendar3. 


If calendar2 is a relative calendar, additional' logic is required to handle the * operation, 
listed above. (A relative calendar is a calendar which contains days marked + or - instead 
of, or in addition to, days marked Y or: N.) Each day in calendar2 which contains a+ or - 
sign is checked against the same day in calendar!. If the day is marked for: execution in 


calendar!, it will be marked for execution, in calendar3~ However, if the day is not marked 
for execution in calendar!, the result depends on, how the day was marked in calendar2: 


• If the day was marked + in1 calendar2, the closest next day marked for execution in 
calendar:! will be marked for execution in calendar3: 


• If the day was marked - in, calendar2, the closest previous day marked for execution, in 
calendar! will be marked for execution incalendar3. 


Operations <W nn and > W nn create a new calendar (calendar3) by shifting the days in, an' 
old calendar (calendar!) a specified number of working days accovding to the specified 
workdays calendar (calendar2): 


Symbol'> indicates that days should be shifted to.the right (i.e., to subsequent days). 


The number of working days to shift is nn' 


The logic for operations < W nn and > W nn is as follows: 


Each day marked for execution in calendar! is checked against calendar2~ 


• If the same day is a working day in calendar2, nn working days in calendar2 are counted 
in the direction of the shift and the resulting day is marked as a working day in 


calendar3~ 


• If the same day is not a working day in' calendar2; the closest working day in the direction 
of the shift is identified in calendar2. Fromi that wo11king day, nn wor:king days in 
calendar2 are counted in the direction of the shift and the resulting day is marked as a 
working day in calendar3 ~ 
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• If operation <>W or ><W is specified, then for each working day (i.e., day marked for 


execution) in calendarl: 


If the same day is a working day in calendar2, it is marked as a working day in 
calendar3. 
If the same day is not a working day in calendar2, the closest wo11king day (in either 
direction) is marked as a working day in calendar3, 
If two working days are equally closest (i.e., the· same number 0:£ days before and after), 
the day selected depends on the parameter specified: 


• If<> W was specified, the earlier working day is selected as the working day for calendar3. 


• If ><W was specified, the later working day is selected as the working day for calendar3. 


Note 
If specifying operator <W nn, >W nn, <>W:. or ><W, calendars must be defined in year 
order, and must contain the same years. 


Activating the Utility 
II EXEC :COABLCAL 


calendarl 
operator 
calendar2 


Where: 


calendar3 


operator is+,-,*, <W nn, >W nn, <>W or ><W 


Return Codes 


0 


8 and above 


Operation performed successfully 


Operation failed 
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Example 1 


The following parameter is passed to·the utility: 


calendalll * calendar2 = calendar3 


Assuming the following calendars: 


s ----------- s ----------- s ------- 
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 
yyyyy 
yyyyyy 
y 


s ----------- s ----------- s ------- 
and 
s ----------- s ----------- s ------- 
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 


y y 
+ - 
+ 
+ 
s ----------- s ----------- s ------- 
The resulting new calendar is: 


s ----------- s ----------- s ------- 
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 


y 
y y y 
y 
y 
y 
s ----------- s ----------- s ------- 
Note the follbwing points in this example: 


IOABLCAL 


calendarl 


calendar2 


calendar3 


• Since the operation is*, days 2 and 3, which are marked fo11 execution in bothcalendarl and 
calendar2, win be marked for execution in calendar3: 


• Day 4 is marked+ in calendar2 and is marked for execution in calendar!. Therefo11e, it will 
be marked for executionin1calendar3. 


• Day 5 is marked- in calendw2 and is marked, fo11 execution in, calendar!. Therefo11e, it will 
be marked for execution in calendar3. 


• Day 6 is not marked in calendar2; Therefore, even though it is marked Yin calendar!, it will 
not be marked for execution' in calendar3. This same reasoning applies to days 8, 9, 10, 11, 
12, 13 and 19. However, days 8, 13 and 19 ave marked for execution for other reasons 
described below. 


• Day 7 is marked + in calendar2 and is not marked for execution in, calendar!. The closest 
following day marked 
1 for execution in calendar! is day 8. Therefore, day 8 will be marked 
for execution' in calendav3: 


• Day 14 is marked + in calendar2 and is not marked for execution in calendar!. The closest 
following day marked for execution in calendar! is day 19. Therefore, day 19 will be marked 
for execution in calendar3: 


• Day 16 is marked - in calendar2 and is not marked fo11 execution in calendar!. The closest 
preceding day marked fo11 execution in, calendalll is day 13. Therefore, day 13 will be marked 
for execution in calendw3: 
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Example 2 


The folfowing parameter is passed to the utility: 


OLDCAL <W 2 WORKDAYS = NEWCAL 


Assuming the following calendars: 


s ----------- s ----------- s ------- 
1 2 3 4 5 6· 7 8 9 + 1 2 3 4 5 6 7 8 9 


y 
y y y 
y 
OLDCAL 


s ----------- s ----------- s ------- 
and 


s ----------- s ----------- s ------- 
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 
yyyy 
yyyy 
yyy 
WORKDAYS 


s ----------- s ----------- s ------- 
The resulting new calendar is: 


s ----------- s ----------- s ------- 
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 


y 
yy 
y y 
NEW CAL 


s ----------- s ----------- s ------- 
Note the following points in this example: 


• Operation <W 2 specifies that fo11 eachwodting day in OLDCAL, IOABLCAL should find the 
corresponding working day in WORKDAYS,. and then shift two wo11kdays to the left. 


• The first workday in OLDCAL is day 5. This is also a workday in: WORKDAYS. The 2nd 
workday to the left of day 5 in· WORKDAYS is day 3, which becomes a workday in NEWCAL. 


• The next workday in OLDCAL is day 10. This is also a workday in WORKDAYS. The 2nd 


wo:rikdayto the left of day lOin WORKDAYS is day 6, whichbecomes aworkdayin NEWCAL. 


• The next workday in OLDCAL is day 11. This is also a workday in WORKDAYS. The 2nd 


wo:rikday to the left of day 11 in WORKDAYS is day 7, which becomes a workday in NEWCAL. 


• The next workday in OLDCAL is day 12:. This is also a workday in WORKDAYS. The 2nd 
workday to the left of day 12 in WORKDAYS is day 10, which becomes a workday in 
NEW CAL. 


• The next workday inOLDCAL is day 15 .. This is not a workday in WORKDAYS. The closest 
workday to the left, in WORKDAYS, is day 13. The 2nd workday to the left of day 13 in 


WORKDAYS is day 11, which becomes aworkday in NEWCAL. 
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IOABLCAL 


Example3 


The following parameter is passed to the utility: 


OLDCAL ><W 
WORKDAYS = NEWCAL. 


Assuming the following calendars: 


s ----------- s ----------- s 
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 


y 
yy 
y 
y 
OLDCAL 


s ----------- s ----------- s 
and 


s ----------- s ----------- s 
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 


y y y y y 
yyyy 
yyy 
WORKDAYS 


s ----------- s ----------- s ------- 


The resulting new calendar is: 


s ----------- s ----------- s ------- 
1 2 3 4 5 6 7 8 9 + 1 2 3 4 5 6 7 8 9 


y 
y 
y 
y 
y 
NEWCAL 


s ----------- s ----------- s ------- 
Note the following points in this example: 


• Operation ><W specifies that for each working day in OLDCAL, IOABL.CAL should find· the 
closest working day in WORKDAYS, andmake that day a workday in NEWCAL. 


• The first workday in OLDCAL is day 5. This is also a workday in WORKDAYS, so it 
becomes a workday in NEW CAL. 


• The next wo11kday in OL.DCAL is day 8. This is not a workday in WORKDAYS. The next 
closest workday in WORKDAYS is day 7, so day 7 becomes a workday in NEWCAL. 


• The next workday in OL.DCAL is day 9. This is not a workday in· WORKDAYS. The next 
closest workday in WORKDAYS is day 10, so day 10 becomes a workday in NEWCAL. 


• The next workday in OLDCAL is day 12: This is also a wo11kday in WORKDAYS, so it 
becomes a workday inNEWCAL. 


• The next workday in OL.DCAL is day 15. This is not a workday in WORKDAYS. The next 
closest workdays in WORKDAYS are days 13 and 17 (which are. equally close to day 15). 
Since the parameter operation statement ><W began with symbol1 >,the value to.the right 
(i.e., the subsequent day) is chosen. Therefore, day 17 becomes a workday in NEWCAL. 
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IOACLRES - Clean IOA Conditions/Resources File 


This utility cleans the IOA Conditions/Resources file of conditions which are no longer 
required. It is recommended that this utility be activated as part o:flOA maintenance. 


Parameters 


Unless the utility is instructed otherwise via parameters, it will delete all prerequisite 
conditions it finds in the Conditions/Resources file. 


The utility outputs a list of all the deleted prerequisite conditions. 


Prerequisite conditions which should not be deleted (e.g., prerequisite conditions needed 
throughout the year) are specified by means of control, statements, which are specified via 
DD statement DACRSIN or SYSIN. The formats of these statements are displayed below, 
followed by explanations: 


IGNORE statements instruct the utility not to delete the indicated prerequisite 
condition(s), as follows: 


• An IGNORE COND statement instructs the utility not to delete the indicated prerequisite 
condition under any circumstances. 


• 
An1 IGNORE CONDIN statement instructs the utility not to delete the indicated 
prerequisite conditions if the utility determines that the prerequisite conditions are 
referenced conditions .. A referenced condition is a prerequisite condition appearing in the 


IOA Conditions/Resources file at the same time that it appears as an IN condition in an 
active job, mission or rule (e.g.,. one which is currently present in the Active Jobs file or 
Active Missions file). 


• cond-prefix specifies the prefix of prerequisite conditions which should not be deleted. An, 
asterisk indicates all prerequisite conditions. 


• If a FROM/TO combination is supplied, a specified condition will! not be deleted if its date is 
in the date range. Conditions not in the date range wiU be deleted, unless they are referred 
to by another IGNORE statement. 


• date can be either a specific date in the site-defined' standwd (mmddyy, ddmmyy or 
yymmdd) or a relative date. A relative date is specified in the format -n, where n is the 
number of days before the cuuent date (e.g., -5 means five days before the current date). 
Relative and specific dates can be mixed (e.g., a specific FROM date and 
1arelative TO date). 
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When, a FROM and/or TO date is not specified, the current date is the default fo11 the 
unspecified date. 


The TO date (regardless of whether specific, relative Oil assumed) cannot precede the 


FROM date. 


CONTROLM and CONTROLD statements indicate whether or not the utility should check 
pllerequisite conditions in the Active Jobs file and/or the Active Missions file, respectively, 
if an IGNORE CONDIN statement is specified. 


By default, each of these files is checked if its respective plloduct is installed (according to 
the IOA Installation options). These statements can be used to override the default. You 


can specify either, both or none of these statements. 


These statements can1 impact the result of: an IGNORE CONDIN statement because the 
utility cannot determine that a prerequisite condition is referenced unless it can check the 
Active Jobs/Missions file for the job/mission 1 containing the IN prerequisite condition .. 


Valid values for these statements are described below: 


CONTROLM 


CONTROLD 


Determines whether or not the CONTROL-M Active Jobs file is 
checked during the cleanup process of the IOA Conditions/Resources 
file .. OptionaL 


YES 


NO 


Check the Active Jobs file. 


Do not check the Active Jobs file. 


Determines whether Oil not the CONTROL-D Active Missions file is 
checked during the cleanup pllocess of the IOA Conditions/Resources 
file. Optional. 


YES 


NO 


Check the Active Missions file. 


Do not check the Active Missions file. 


The utility can be run simultaneously with the CONTROL-M and the CONTROL-D 


monitolls. 


If the job is submitted under CONTROL-M, Auto Edit variables are suppo11ted. 


Activating the Utility 


I I EXEC :COACLRES 


Return Codes 


0 


4 


8 and above 
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Operation perfol'med successfully 


Execution errol', operation stopped 


Critical error, task not performed' 


IOA Rel. 5.0.0 Administrator Guide 


u 


u 


u 


u 


IOACLRES 
Section 9: Utilities 


Example 1 


It is recommended that you run this job· weekly. Since this job contains AutoEdit variables, 
it must be submitted directly via the CONTROL-M monitor. (The example assumes date 
standard 
mmddyy. 
For 
ddmmyy 
format, 
the 
AutoEdit 
variable 
should 
be 


%%ODAY. %%0MONTH. %%0YEAR. For yymmdd format, the AutoEdit variable should be 


%%0YEAR.%%0MONTH. %%ODAY.) 
II EXEC :COACLRES 


:CGNORE COND * FROM -10 TO %%0MONTH.%%0DAY.%%0YEAR 


:CGNORE COND C:CCS 


:CGNORE COND DB• 


Example 2 


Clean the resources file of all p11erequisite conditions not referenced by jobs in the Active 
Jobs file,. except those prerequisite conditions beginning with CICS. (Prerequisite 
conditions beginning with CICS are not deleted.) Do not check the Active Missions file to 
see if a p11erequisite condition is referenced. 


II EXEC :COACLRES 


:CGNORE CONDJ:N * CONTROLD NO 


:CGNORE COND C:CCS 
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IOACND • Perform Condition/Resource Adjustments 


This utility adds, verifies the existence ofi, deletes, or modifies prerequisite conditions and 
resources in the IOA Conditions/Resources file. It can' be activated by the operator as a 
started task (STC), fromi TSO, or from within a user program, 


The addition1 deletion, modification Oil verification, is recollded three ways:. in the job 
sysout, as a message on the operatoll console, and, as an event in the IOA Log file. 


Parameters can be received by the utility in two ways: via DD statement DACNDIN (or 


SYSIN), or via PARM. The parameters required depend on whether prerequisite 
conditions, control 
1 resom~ces or quantitative resources are being processed. 


If it is necessary to add, delete, verify or modify prerequisite conditions or resources 
during a job, step, the utility can' be called, as a procedure from within the application1 


program using procedure name CTMCND, as described later in "Activating the Utility 
(and Examples)." 


Parameters for Processing Prerequisite Conditions 


action COND condition· condition-date 


Whelle: 


action1 


condition 


condition ... date 
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Action, to be perfollmed by the utility. Valid actions are: 


ADD 


DELETE 


CHECK 


Add the specified prerequisite condition, 


Delete the specified prerequisite condition. 


Verify' the existence of the specified prerequisite condition. 


1-20 character pllerequisite condition. 


Date associated with the prerequisite condition. Valid actions are: 


Any specific date (in format mmdd or ddmm, depending on' the site 
standard) 


DATE 


WDATE 


Current Gregorian, date 


IOA Installation working date 


Date character-masking foll DELETE and CHECK functions is 
supported as follows: 


* 


**** 


*2*2 


Months: 


Days: 


Represents any value in the co:vresponding position ofi the 
date (format mmdd or ddmmi dependiilg on the site 
standard). Up to four asterisks can be specified. Fo:ri 


example: 


Any date 


Valid, combinations of: 


February and December 


02, 12, and 22 
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Parameters for Processing Control Resources 
action CONTROL resource control 


Where: 


action 


resource 


control, 


Action to be perfo11med by the utility. Valid actions are: 


ADD 


DELETE 


Add the specified Control resource under the specified 
type of controh 


Delete the specified resouJ)ce which is under the specified 
type of controL 


Resource name. 


Type of control. Valid values a11e: 


E 
s 


Exclusive controL 


ShaJ)ed controh 


Parameters for Processing Quantitative Resources 


action, RESOURCE resource quantity 


Where: 


action 


resource 


quantity 


Action to be performed, by the utility. Valid actions are: 


ADD 


DELETE 


CHANGE 


Add the specified Quantitative resource with the quantity 
specified. quantity is mandatory. 


Delete the resouJ)ce (and the entire existing quantity). 
quantity must not be specified. 


Adjust the existing quantity of the Quantitative resource 


to, or by the value specified in quantity. quantity is 


mandato:ey. 


Quantitative resource name. 


Quantity of the Quantitative resource. 


For CHANGE actions, valid values can have the format n, +n, or -n 
where n is an, integer. When n is specified, the quantity of the 
Quantitative resource is set to n. When +n or -n is specified,. the 
quantity is increased or: decreased by n' 


For ADD or: DELETE actions, valid values can only have the format n, 
where n is the quantity of the Quantitative resource to be added or 
deleted. 
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Activating the Utility (and Examples) 


As a job step: 


//C'JSfDl EXEC IOACND' 


ADD COND JOB•A-ENDED-OL 0505 


DELETE COND JOB-A-DID-NOT-RUN 0505 


CHANGE RESOURCE TAPE -1 


ADD RESOURCE INIT-CPUA 3 


DELETE RESOURCE INIT-CPUB 


ADD CON'l'ROL PROD-DATA-BASE E 


IOACND 


As a job, containing AutoEdit val'iables, submitted th11ough the CONTROL-M monito11: 


//CNDl EXEC IOACND 


ADD COND 
AR•FILE-009•CREATED 
%%OMONTH.%%0DAY 


As an, operator command: 


S IOACND,PARM='ADD COND END-CICS 0[02' 


As a called p11ocedure in an, application p11ogramc 


CALL· C'rMC'JSfD, {PARMCOND), VL 


L'llR 
R15,R15 


BNZ 
ERROR 


PARMCOND DC 
AL2{80) 


DC 
CLSO,•ADD COND CICS-F 


Note 
Program IOACND works in 24-bit addressing mode .. The program is reusable but not 
re-entrant .. The program operates in AMO EE 24. 


ILE-CLOSED 0[012' 


Return Codes 


ADD 


DELETE 
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0 


8 


12 and above 


0 


8 


12 and above 


Prerequisite condition or resoul'ce added 


Prerequisite condition or resou11ce afoeady exists 


Function failed 


Prerequisite condition deleted 


Prerequisite condition to be deleted does not exist 


Function failed 
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CHECK 
0 


8 


12 ·and above 


Prerequis.ite condition1 exists 


Prerequisite condition does not exist 


Function failed 
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CHANGE 
0 


8 


Quantity of Quantitative resource adjusted successfully 


Quantitative resource does not exist 


Note 


12andabove 
Function failed 


If you are working in a VM I CMS environment, utility· JOA VCND can be used to set 
prerequisite conditions in a CONTROL-M monitor running on an NJE-connected MVS 


machine. 


The EXEC statement for utility!OAVCND utilizes·standard IOACND input, and sends 
a job. to the MVS node to set the conditions. 


Example 


EXEC 
IOAVCND' 


1ADD COND VM-READY 
STAT' 
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IOACOPRS - Copy/Resize IOA Conditions/Resources File 


This utility copies the contents of the IOA Conditions/Resources file to another 
Conditions/Resources file which may or may not be the same 011 size 011 version. 


Copying/Resizing the IOA Conditions/Resources File 


Note 
Utility IOACOPRS cannot run simultaneously with the JOA product monitors (e.g., 


CONTROL-M monitor). If the monitors are not shut down, the utility will terminate. 
Online users may remain logged on, but should not access the Online facility· while the 
size of the Conditions I Resources file is being changed. 


To change the size of the IOA Conditions/Resources file, perfo11mi the following steps: 


1. Change IOA installation parameters RESLREC and RESREC# in member IOAPARM to,the 
required new IOA Conditions/Resources file size. 


2. Reassemble member IOAP ARM using job IOAP ARMJ. 


3. After doing this, every access to the IOA Conditions/Resources file (onlfue or batch) willtry 


to utilize the new size and may abend. Therefore, all access to the IOA Conditions/ResoUllces 


file should be stopped until the process is complete. 


4. Change parameter LRECL and RECNUM in· p11ocedw.ie IOAFFRES to the new size of the 


IOA Conditions/Resources file. 


5. Run member FORMRES in the IOA INSTALL library after changing the dataset names (so 


you will' not override the existing IOA Conditions/Resources file and its backup file). 


If you are wo11king in· dual checkpoint mode, run. member FORMDRES. 


Note If you are working in dual checkpoint mode, the mirror file must also be allocated 
with the new size before starting the JOA product monitors (e.g., the CONTROL-M 


monitor). Otherwise, the monitors mayabend. 


6. Run utility IOACOPRS. 


The utility will copy the current IOA Conditions/ResoUllces file to the new IOA 
Conditions/Resou11ces file; 


7. Rename the old· IOA Conditions/Resources file (and its mirror file - suffix ALTRES), 


8. Rename the new IOA Conditions/ResoUllces file (and its miuor file - suffix ALTRES) to the 
former names of the old files. 


9. Restart the IOA product monitors and resume operation. 


The utility must terminate with a return code ofi 0. 


Parameters 


The utility receives parameters via the invocation• of the p11ocedure. 


OLD RES 
Name of the old IOA Conditions/Resources file. 
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OLDSNC 


NEWRES 


NEWSNC 


Name of the old IOA Conditions/Resources Synchronization file. 


Name of the new IOA Conditions/Resources file. 


Name 0£ the new IOA Conditions/Resources Synchronization file. 


Return Codes 


0 
Operation' performed successfully 


Operation' failed 
8 and above 


Activating the Utility (and Example) 


II 
II 
II 
II* 
II 
II* 
II 
II* 


EXEC 
I:OACOPRS, 


OLDRES= 1 I:OA.old.RES 1 , 
OLDCONDI:TJ:ONS/RESOURCES 


OLDSNC='I:OA.old.SNC', 
OLD·CONDI:TJ:ONS/RESOURCES 


SYNCHRONI:ZATI:ON FI:LE 


NEWRES='I:OA.new.NEWRES', 
NEW CONDI:TI:ONS/RESOURCES 


FI:LE 


NEWSNC='I:OA.new.NEWSNC' 
NEW CONDJ:TI:ONS/RESOURCES 


SYNCHRONI:ZATI:ON FI:LE 
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IOACPLOG - Copy the IOA Log File 


Utility IOACPLOG copies the contents 0£ the IOA Log file. The contents can be copied to a 
sequential file or to another Log file. Usage of the utility depends on the type of target file. 


Copying to a Sequential File 


The log is generally copied to a sequential file for archiving purposes. The sequential file 
can then be resto11ed access under ISPF (e.g., b11owsing) and for use by report generators. 


A date range for the log reco11ds to be copied can be specified. If a date range is not 
specified, the entire Log file is copied. 


The target sequential file is specified in: DD statement DALOGSEQ. 


It is recommended that the utility be used on a daily basis to copy the contents of the Log 
file to a sequential file .. Use of AutoEdit parameters can simplify the p11ocess. 


Parameters 


Parameters are supplied via DD statement DALCPPRM (011 SYSIN). The utility procedure 
contains a reference to the existing Log file, in DD statement DALOGCUR. 


COPYTOSEQ 


FROMDATE yymmdd 


TODATE yymmdd 


Indicates that the utility is being used to copy records from the IOA 


Log file to a sequentiaUile. 


Eadiest Log record date used to select records to be copied. 
AutoEdit variable are supported. 


Latest log record date to used to select records to be copied. 
AutoEdit variable are supported. 


Activating the Utility (and Example) 


II* %%SET %~oD = %%CALCDATE %%ODATE -1 


II 
EXEC IOACPLOG 


llDALOGSEQ DD DSN=prefix.seqfile,DISP= 


llDALCPPRM DD* 


II 


COPYTOSEQ 


FROMDATE %~oD 


TODATE %~oD 


Return Codes 


Indicates the target sequential file 


0 


Other 


Operation performed successfully 


Operation failed 


Copying to a Log File 


This function is generally used to copy the Log file to another, larger Log file when it 
becomes necessary to· enlarge the size of the Log file. 


The target Log file is specified in DD statement DALOG. 
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Parameters 


Parameters are supplied via DD statement DALCPPRM (or SYSIN). The utility pvocedure 


contains a reference to· the existing Log file, in DD statement DALOGCtJR. 


COPYTOLOG 
Indicates that the utility is being used to copy the IOA Log file to 
another Log file. 


Activating the Utility (and Example) 


II EXEC IOACPLOG 


llDALOG DD DSN=prefix.logfile,DISP= 


llDALCPPRM DD * 


COPY'l'OSEQ 
II 


Return Codes 


Indicates the target Log file 


0 


Other 


Operation, performed successfully 


Operation failed 
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IOADBF ·Allocate/Format an IOAAccess Method File 


Utility IOADBF is used to allocate and fortmat an IOA Access Method file's data and index 
components. 


Parameters 


The following pavameters can be specified, to the utility in the EXEC statement which 
invokes the IOADBF JCL pr:ocedure: 


FUNC 


D 


M 


Function to· be performed: 


INIT 


FORM 


EXTEND 


CHANGE 


DBALOK 


Allocates and initializes (formats) a new IOA Access 
Method file component. 


Reformats an1 existing IOA Access Method file component. 


Allocates and formats a new secondary extent for an' 
existing IOA Access Method file component. 


Changes/Updates an IOA Access Method file component's 
internal attribute settings. This function should be used 
when it is necessary to change the settings of parameters 
in an IOA Access Method file definition after the file has 
been created, 


Resets the flag that indicated a corrupted Dual Mirror 
Image file (DUALBAD). This function 1 should be used after 
a corrupted Dual Mirror Image file has been resto!'ed via 
utility IOADCPY. 


Dataset name suffix of the IOA library containing the IOA Access 
Method file Definition, Statements member. The member name is 
specified via parameter M below. 


Name of the IOA lib11ary member which contains the IOA Access 
Method file Definition Statements and whose dataset name suffix is 
specified via pa:vameter D above. 


DD Statement DAFILE 


When1 executing utility IOADBF with parameter FUNC set to EXTEND ov CHANGE, a 
DAFILE DD statement, specifying the name ofi the IOA Access Method. file component's 


p11imary dataset extent, must be included in the JCL step executing the utility. 
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JOA Access Method File Definition Statements 


The following IOA Access Method, file definition statements can be specified as input to 
utility IOADBF in the IOA library and member referred to above by EXEC statement 
pa11ameters D and M: 


TYPE 


DSN 


UNIT 


VOL 


UNITID 


VOLD 


IOA Access Method file type: 


F 


I 
v 


Data component, fixed reco11d fo11mat. 


Index component. 


Data component, variable record fol1IIlat. This value is not 
valid for use with CONTROL..-B files. 


The TYPE statement is not applicable when executing utility IOADBF 
with the FORM 011 CHANGE function specified~ 


IOA Access Method, file's dataset name, excluding the extent number 
suffix (.EOOO through .E255) which is appended automatically by the 
utility when the IOA Access Method file is allocated~ 


The DSN statement is not applicable when executing utility IOADBF 


with the !NIT.FORM or CHANGE function specified. 


Name ofi the DASD unit to be used when allocating a new IOA Access 
Method file extent (e.g., 3390). 


List ofi one to six DASD volume serial numbers, enclosed in 
parenthesis and separated by commas, on which the IOA Access 
Method file's extents can be allocated. 


All volumes must be defined to MVS as being associated with the unit 
name specified in parameter UNIT above. 


If an out-of~space condition occurs due to· lack of space in the specified 
volumes, additional1 volumes can be added~ (A maximum of six volumes is 
permitted.) Utility IOADBF should be executed with EXEC parameter 


FUNC=CHANGE (this stores the new setting internally within the IOA 


Access Method.file) and then the CONTROL-D monitor should be restarted, 


If VOil. is not specified, the IOA Access Method file will1 be allocated using 
only parameter UNIT. 


Name of the DASD unit to be used when allocating a new dual mirro11 


image file extent (e.g., 3390). 


List ofi one to six DASD volume serial numbers, enclosed in 
parenthesis and separated by commas, on which the dual mirror 
image file's extents can be allocated. 


Note 
It is recommended that you specify different volumes for the 
primary and dual mirror copy of each file to ensure greater data 
integrity; 
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SPACE 


DBAL 


DU ALM 
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Amount 0£ space, in blocks, to, be allocated fo11 the primary and, 


optionally, for each secondary IOA Access Method file extent. 


Note 
Secondary extents cannot be specified for CONTROL-B files. 


It is recommended that a secondary space amount be specified to 
avoid termination of the CONTROL-D ·monito11 when the p11imary 


extent becomes full and an out of space condition is detected. 


If an out of space condition occurs, secondary extent allocations can be 
set by specifying a secondary amount in, parameter SPACE, executing 
utility IOADBF with EXEC parameter FUNC=CHANGE (this stores 
the new setting internally within the IOA Access Method file), and 
restarting the CONTROL-D monitor. 


Example 1 


SPACE=(1500) 


Example 2 


SF ACE=( 1500,300) 


A 1500-block IOA Access Method file is allocated. 
If the file becomes full\ the CONTROL-Brule will: 


terminate. 


A 1500~block IOA Access Method file is allocated. 
If the· file becomes full and a secondary extent is 
automatically or manually allbcated (see IOA 


Access 
Method 
file 
Definition 
parameter 
EXTEND), each newly-allocated' extent will be 


300 blocks in· size. 


Parameter SPACE's primary space amount is not applicable when 
executing utility IOADBF with the FORM or CHANGE function 
specified. 


Y (Yes) 


N(No) 


Y (Yes) 


N(No) 


Allocate a dual mimor image copy of the specified 
file. The dual mirror image file's contents are 
kept synchronized, with the contents of the 
primary file. Use of the dual, mirror image file 
provides maximum data recovery capabilities 
when the primary file's disk or contents become 
damaged or inaccessible. Specifying DBAL=Y is 
recommended for the Data component file. 


Do not allocate a dual, mirror image copy of the 
specified file. 


If dual mimor image file p:r~ocessing is used~ the 
execution terminates if a non-recoverable 110 


error occurs while processing the dual mirror 
image copy of the file. 


If dual mirror image file processing is usedi 


execution' continues if a non-recoverable 1/0 error 
occurs during processing of the dual mirror 
image copy of the file. 
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DUALST 


EXTEND 


BLKSIZE 


Y (Yes) 


N(No) 
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Timestamp. checkpoint processing is performed 


intern.ally to· ensure that the primacy and. dual: 


miuol1 image copies of the file we fully 


synclrnonized with each other. Enablfug this 
option insUl!es greater data integrity at the 
expense of increasing 110 processing overhead. 


Timestamp 
checkpoint 
processing 
is 
not 


performed. 


Refer to "CONTROL-D Installation Considerations" in the IOA 


Installation Guide for mo11e information. 


Specifies secondary extent to be allocated·. This pa11ameter is not valid 
for use with CONTROL-B files. 


Specifying A (the default) causes a secondary extent to be 
automatically allocated when an out of space condition is detected. 


Specif:ying M. requires a secondary extent to be manually allocated 


after an out of space condition. is detected by executing the utility with 
EXEC parameter FUNC=EXTEND specified. 


Parameter EXTEND is igno11ed if no secondal1y space amount is 
specified via pa11ameter SPACE. 


Parameter EXTEND is not applicable when executing utility IOADBF 


with the FORM or CHANGE function specified. 


Blbcksize of the IOAAccess Methodfile, in1bytes. For aUindex components 
and for data components with variable length records, it is recommended 
that the block size be set to· the maXimum half track capacity of the device 
on1whichthe IOA Access Method file is allbcated, as follbws: 


BLKSIZE=19068 


BLKSIZE=234 76 


BLKSIZE=27998 


BL..KSIZE=22928 


For 3350 DASD devices. 


For 3380 DASD devices. 


For 3390 DASD devices. 


For 9345 DASD devices. 


For data components with fixed length records, where the block size 
must be a multiple of the record length, it is recommended that the 
block size be set as close to, without exceeding, the device's half track 
capacity. 


Parameter BLKSIZE is not applicable when executing utility IOADBF 


with the FORM or CHANGE function specified. 
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BUFL 


LRECL 


KEYLEN 


COMPRS 


COMPTB 
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Number of I/O buffers for which extended storage will be obtained to 
access the IOA Access Method file. 


Note 
This parameter is not valid for use with CONTROL-B files. 


Buffer length is determined by parameter BLKSIZE, described above. 
A larger number imp11oves I/O th11oughput at the expense of increased 


sto11age 
requirements. 
A 
smaller 
number 
reduces 
sto11age 


requirements at the expense of degrading I/O throughput. 


Logical reco11d length for IOA Access Method file data components 
only. This parameter should not be specified for index components. 


The setting for parameter LRECL is IOA application, dependent and 
should not be modified unless instructed otherwise by Technical 
Support. 


Parameter LRECL is not appl!icable when executing utility IOADBF 


with the FORM 011 CHANGE function specified'. 


Record key length for IOA Access Method file index components only. 


This parameter should not be specified, fo11 data components. 


Parameter KEYLEN is not applicable when executing utility IOADBF 


with, the CHANGE function specified. 


The setting for KEYLEN is IOA application' dependent and should not 
be modified, unless instructed, otherwise by Technical Support. 


Name of the IOA supplied routine to perform Data component record 


comp:vession, This pa:vameter should not be specified for index 
components. 


Notes 
Parameter COMPRS is not available when executing utility 
IOADBF or with the CHANGE function specified. 


Parameter COMPRS is not available when executing utility 
IOADBF on a CONTROL-D file. 


The setting fo11 COMPRS is IOA application, dependent and should not 
be modified unless instructed otherwise by Technical Support. 


Name of the IOA supplied compression table to be used by the 


comp11ession routine when performing data component reco11d 


compression1. This pa:vameter should not be specified for index 
components. 


Notes 
Parameter COMPTB is not available when executing utility 
IOADBF with the FORM or CHANGE function specified. 


Parameter COMPTB is not available when executing utility 
IOADBF on a CONTROL-B file. 


The setting for COMPTB is IOA application dependent and should not 
be modified unless instructed otherwise by Technical Support. 
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Example 1 


/ /:CN:C'l' 
EXEC 
:COADBF,FUNC=:CN:C'l',D=:CNS'l'C'l'D,M=DEFAC'l' 


Contents of member DEFACT inthe IOA INSTCTD library: 


'l'YPE=V 


DSN=C'l'D~VSOO.AC'l' 


BLKS:CZE=27998 


LRECL=27974 


SPACE= (10001200') 


BUFL=lOO' 


UN:C'l'=3390' 


VOL=(PRD021,PRD022,PRD023,PRD024,PRD025,PRD026) 


COMPRS=C'l'DUFCM 


COMP'l'B=C'l'DUFCMA 


Example2 


//CHANGE 


//DAF:CLE 


EXEC 


DD 


:COADBF,FUNC=CHANGE,D=:CNS'l'C'l'D,M=DEFHS'l':C 


D:CSP=SHR1DSN=C'l'D.VSOO.HS'l':C.EOOO, 


CONTROL-D Samples 


Refer to sample jobs FORMUFl and: FORMUF2 in the IOA INSTCTD library for examples 
of how to allocate and format IOA Access Method files. 


CONTROL-B Samples 


Utility IOADBF is used by the followingjobs in1 the INSTCTB library. Refer to these jobs 
for additional examples. 


CREFABF 


CREFBKP 


CREFDBM 


CREFDBV 


CREFGRP 


CREFJAF 


CREFREP 


CONVABF 


CONVGRP 


CONVJAF 


CONVMOD 


Allocates and formats the Active Balancing file. 


Allocates and formats the Active Balancing file backup file. 


Allocates and formats the Database Variable Basic file. 


Allocates and formats the Database Variable Generationifile. 


Allocates and formats the Group file. 


Allocates and formats the Rule Activity file. 


Allocates and fo11mats the Repo11t file. 


Converts the Active Balancing file from CONTROL-B Release 1.2.0 to 
the format for Release 5.0.0~ 


Converts the Group file from CONTROL-B Release 1.2.0 to the fo11mat 


for Release 5.0.0~ 


Converts the Rule Activity file from CONTROL-B Release 1.2.0 to the 


fol'mat for Release 5~0.0. 


Converts the IOA Access 
Method Variable 
Basic file 
from 


CONTROL-B Release 1.2.0 to the fol'mat for Release 5.0.0. 
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CONVREP 


CONVVAR 


IOADBF 


Converts the Report file from CONTROL-B Release 1.2.0 to the format 
for Release 5.0;0. 


The following jobs can, be used as samples for formatting existing data and index files: 


JOBFABF 


JOBFGRP 


JOBFMOD 


JOBFVAR 


JOBFBKP 


JOBFJAF 


JOBFREP 


Active Balancing file 


Group file 


I OA Access Method Variable Basic· file 


I OA Access Method Variable Generation, file 


Backup file 


Rule Activity file 


Report file 


The following jobs can be used as samples for formatting and rebuilding the index file for 


an existing data file: 


JOBBGRP 


JOBBBDM 


JOBBDBV 


JOBBJAF 


JOBBREP 


Example 


Group.file 


Access Method Variable Basic file 


Access Method Variable Generation file 


Rule Activity file 


Report file 


If the index file of the Rule Activity file was damaged by a disk crash but the data file was 
not damaged (i.e., the actual information: about invocations, etc., is accurate), use member 
JOBBJAF to·refo11mat the index file and rebuild the index entries. 
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Section 9: Utilities 


IOADBSR - Sort Records in an IOA Access Method Data 
Component 


Utility IOADBSR sorts the reco11ds in an IOA Access Method file's data component in the 
same logical order as the records in: the associated' IOA Access Method file's index 
component. 


Sorting an IOA Access Method file's data component improves the I/O performance .. 


·Note 
The CONTROL-D Active User Report List file's data component can optionally be 
sorted automatically by the CONTROL-D monitor. See "Dynamic Sorting of the Active 


User Report List File" in Section 4 of this guide for more information. 


Parameters 


The following pa11ameters can· be specified to the utility in the EXEC statement which 
invokes the IOADBSR JCL procedure: 


DBPREFA 


DB FILE 


PARMLIB 


M 


High level dataset name qualifier (prefix) of the IOA Access Method 
file. 


IOA Access Method file's dataset name suffix. 


The last qualifier of the IOA product library containing the input So11t 
Control statements. 


Member name in the IOA product dataset containing the input Sort 
Control statements. 


Sort Control Parameters 


The following Sort Control· parameters can be specified fo11 dynamic sovting. Parameters 
that a11e not applicable to batch1 sorting with utility IOADBSR are indicated as such. 


ENABLE 


TIME FROM 


TIMETO 


RBAOFS 


Whether or not dynamic sort pvocessing should be disabled .. This 
parameter is ignored by utility IOADBSR. 


Y (Yes) 


N(No) 


Enable dynamic sol1t processing. 


Disable· dynamic sort processing~ 


Earliest time of day, in hhmm format, at which time dynamic sort 
processing may be performed. This parameter is ignored by utility 


IOADBSR. 


Latest time of day, in hhmm format, at which time dynamic sort 
p11ocessing may be performed. This parameter is ignored by utility 


IOADBSR. 


Offset location, within1 an index record of a four-byte field containing 
the address of the associated data reco11d. 


This parameter is for internal use only and should not be modified 
unless instructed otherwise by Technical Support. 
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INTERVAL 


DELYBLK 


START-WHEN- 


OVER 


STOP-WHEN- 
OVER 


Example 


IOADBSR 


Interval, in, hhmm format, at which dynamic sort processing will 
automatically start during the time range specified by parameters 


TIMEFROM and TlMETO. This parameter is igno11ed by utility 


IOADBSR. 


Amount of time, as a four-digit value, in, hundredths of seconds, that 
dynamic sort processing will wait before processing a new block. For 
example, a value of 0001, 0010 or 0100 will set the delay time to one 
hundredth, one tenth 011 one full second, respectively. 


Limit ofi different Database file data component blocks referred to by 
all index records within any single index component block that will 
automatically trigger dynamic·sort processing. 


This parameter is for internal use only and should not be modified 
unless instructed otherwise· by Technical Support. 


Maximum number of different data component blocks that can be 
referred to by all index records within any single index component 
block when dynamically so11ting the index component block. 


The STOP-WHEN-OVER parameter is for internal use only and 


should, not be modified unless instructed otherwise by Technical 
Support. 


II 
EXEC IOADBSR,DBPREFA=CTD, 
II 
II 
II 


DBFILE=ACT, 


PARMLl:B='CTD.PROD.PARM', 


M=DBSRTPRM 


Refer to sample job CTIHJFSR in the CONTROL-D JCL library for an' example of how to 


so11t the data component of the CONTROL-D History User Report list. 
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IOADCPY ·Recover an IOAAccess Method File 


Utility IOADC::PY is used to recover an IOA Access Method file from the dual mirror image 
copy, and vice versa. 


If an IOA Access Method file is used with dual file support, and either the working copy or 
the dual mirror image copy is corrupted or becomes unavailable, the damaged, or missing 


file must be recovered. Utility IOADC::PY restores the damaged or missing copy of the file 


from the copy that is still intact and available (including all file extents). If the dual 1 copy 
is corrupted, the utility also resets the parameter in the control block of the IOA Access 
Method file that indicated a corrupted dual mirror: image file (DUALBAD). 


Activating the Utility 


//COPY 
EXEC 
IOADCPY,DBFILE=ACT,SUFFIX=EOOO 


When executing this utility, DD statement DAIN must be included in: the JCL stream, and 
must specify the full' name of the IOA Access Method file uncorrupted copy. 


Note 
When using this· utility; the activities of all the relevant applications should be stopped. 


See the relevant product section for more information on the recovery process. 


Examples 


If the dual:mirro11 image copy of the CONTROL..-D Active User Report List is corrupted, the 
DAIN DD statement should specify the name of the main copy:· 


//DAIN DD DISP=SHR,DSN=CTD.PROD.ACT.E000 
1 


If the main copy of the CONTROL-D Active User Repo11t List is corrupted1 the DAIN DD 


· statement should specify the· name of the dual mirror image copy: 


//DAIN DD DISP=SHR1DSN=CTD.PROD.ACT.D000 1 


Parameters 


The following parameters can, be specified to the utility in1 the EXEC statement which1 
invokes the IOADCPY JCL procedure: 


SUFFIX 


UNIT 


VOL.. 


Suffix of the dataset name of the uncorrupted file. 


EOOO 


DOOO 


If the dual mirro11 image copy is co!1rupted, the suffix of 
the main copy of the IOA Access Method file should be 
specified. 


If the main copy is corrupted, the suffix of the dual, mirror 
image copy of the IOA Access Method, file should be 


specified~ 


Name of the DASD unit to be used when allocating new extents for the 
damaged or missing file. 


List of one to· six DASD volume serial numbers, enclosed in pa11enthesis 


and separated by commas, on, which the new extents of the damaged or 
missing file can be allocated~ 
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All volumes must be defined to' MVS as being associated with the unit 
name· specified in 
1 parameter UNIT above. 


If VOL is not specified~ the extents will be allocated using only parameter 
UNIT. 


The above parameters are optional, and should only be used when it is necessary to 
override the UNIT and 1 VOL. (011 UNITD and VOLD) parameters specified in the IOA 


Access Method file definition, member when the IOA Access Method file was first created 
(member DEFxxx in, the IOA INSTCTx lib11ary) .. After running the utility with these 
parameters, run utility IOADBF with FUNC=CHANGE specified to update the new values 
for these parameters in1 the IOA Access Method file control' block. 


Return Codes 


0 


4 


8 


12 


16 


20 


24 


28 


32 


36 


Operation performed successfully 


Missing DD statement 011 open error occurred for SYSPRINT file 


Missing DD statement or open error occurred fo11 input IOA Access 
Method file 


Error in input parameters 


Error in' IOA Access Method file name 


E11ror occurred in dynamic allocation 


Internal error occurred 


Insufficient storage 


Missing DD statement 011 open error occurred for output IOA Access 
Method file 


Erro11 in input pa11ameters - volume serial 
1 number was not supplied 


See sample member CTDUFCPY in the CONTROL-D JCL lib11ary for more details on how 
to use this utility. 
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IOADIG ·Verify Integrity of an IOA Access Method File Data 
Component 


Utility IOADIG is used' to verify the integrity of an IOA Access Method file's data 
component structure. If instructed, utility IOADIG will co11rect the errors that have been 
detected. 


Note 
All file-related activity of the relevant product must be stopped before this utility·is run: 


• If the file being processed is a CONTROL-D file, all CONTROb-D monitors should 
be down when running this utility; 


• If the file being processed is a CONTROb-B file, all the CONTROL-B activities 
should be held, e.g.,. no' CONTROL-B rules should be invoked while this utility is 
running. 


Activating the Utility 


//CHECK 
EXEC 
J:OADJ:G,DBFJ:LE=filename,FUNC=RIW 


Parameters. 


The following parameters can be specified to the utility in the EXEC statement which 
invokes the IOADIG JCL pi;ocedure. 


DBFILE 


FUNC 


Example 


//CHECK 
EXEC 


IOA Access Method, file's identifier name (DBNAME) suffix. 


Function to be performed on the file. 


R 
w 


Report errors detected. 


Report and: correct errors detected. As a precaution, it is 
recommended that a backup copy be made of the IOA 


Access Method file data component prior to executing 
utility IOADIG with parameter FUNC set to W. 


J:OADJ:G,DBFJ:LE=HST,FUNC=R1 


Refer to sample job CTDUFCHK in: the CONTROL-D JCL library for an example of how to 
check the structural integrity of an IOA Access Method file data component. 
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IOADII - Verify Integrity of an IOA Access Method File 
Index Component 


IOADII 


Utility IOADII is used to verif:y the integrity 0£ an IOA Access Method file's index 
component structure. If errors are detected, the index component should be rebuilt using 
the appvopriate index rebuilding utility (e.g., CTDDIB for CONTROL-D files or CTBDBIB 


fo11 CONTROL-B files). 


Activating the Utility 


//CHECK 
EXEC 
IOADII,DBFILE=filename 


Parameters 


The following parameters can be specified to the utility in the EXEC statement which 
invokes the IOADH JCL procedure. 


DB FILE 
IOA Access Method file's dataset name suffix. 


The utility also provides the numbe11 of reco:rids in the file. 


Example 


//CHECK 
EXEC 
IOADII,DBFILE=GRP 


Refer to sample job CTDUFCHK in the CONTROL-D JCL libra11y fo:ri an example 0£ how to 
check the structural integrity of an IOA Access Method file index component. 
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Section 9: Utilities 


IOADLD - Load IOA Access Method File Contents 


Utility IOADLD is used; to load an IOA Access Method file's contents fromi a sequential file 


p11eviously created by utility IOADUL. 


Notes 
Al,l activity· of the relevant product must be stopped before this utility is run. For 
example, if the file being processed is a CONTROL-D file, all CONTROL-D monitors 
should be down when running this utility. 


Utility10ADLD cannot be run on CONTROL-B files. 


This utility is typically used when an IOA Access Method file is migrated to another DASD 
volume. 1n, this case, the following are perfo11med: 


1. Utility IOADBL is run to unload the IOA Access Method file data component's reco11ds to a 
sequential dataset. 


2; A new IOA Access Method file is allocated on a new DASD volume. 


3~ This new IOA Access Method file is formatted. using utility IOADBF. 


4. Utility IOADLD is executed to· reload the IOA Access Method file data component reco11ds 
from the sequential dataset previously produced by IOADBL. 


5 .. The appropriate index rebuilding utility (e.g., CTDDIB for CONTROL-D files) is executed to 
rebuild the IOA Access Method file index component based on the data component's reco11d 


contents. 


Activating the Utility 


//LOAD 
EXEC 
J:OADLD 


Parameters 


The following pa11ameters can' be specified to the utility in the EXEC statement which 
invokes the IOADLD JCL procedure: 


SQFILE 


DB FILE 


Example 


//LOAD 
EXEC 


Input sequential file's dataset name suffix. 


Output IOA Access Method file's dataset name suffix. 


J:OADLD,SQFJ:LE=ACTSEQ,DBFJ:LE=ACT 


Refer to, sample job CTDUFRST in: the CONTROL-D JCL library for an example of how to 
load an IOA Access Method file's data component re.co11ds from a sequential dataset and 
then rebuild the IOA Access Method file's index component. 


IOA Rel. 5.0;0 Administrator Guide 
9-37 


Section 9: Utilities 
IOADPT 


IOADPT • Print IOA Access Method File Content 


Utility IOADPT prints IOA Access Method file data and index records in, SNAP dump 
format. 


Activating the Utility 


//PR:CNT 
EXEC 
J:OADPT 


Parameters 


The following parameters can be specified to the utility in the EXEC statement which 
invokes the IOADPT JCL procedure. 


FUNC 


DB FILE 


KEYFROM 


KEYTO 


RBAOFF 


Print function' to be performed. 


0 
Print IOA Access Method file index and data components. 


1 
Print IOA Access Method file index component only. 


DBO 
Print IOA Access Method file index and data component 
control reco11ds. 


IOA Access Method file's identifier name (DBNAME) suffix. 


Value of the record key from which to pl1int. Optional. 


Value of the reco11d key until which to print. Optional. 


RBA offset in the index record key pointing to the data component 
record. The default setting fo11 this parameter is 0. 


This utility pvocesses both, the data and index components of a IOA Access Method file. 


If KEYFROM and KEYTO pa11ameters are not specified 011 ave specified as blank, all 
records are p11inted. 


Example 


//PR:CNT 
EXEC 
J:OADPT,FtJNC=01DBFJ:LE=ACT 


Refer to sample job CTilUFDPT in the CONTROL-D JCL libravy for an example of how to 
print IOA Access Method file record contents. 
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IOADUL · Unload IOA Access Method File Contents 


Utility IOADUL is used to unload an IOA Access Method file data component's reco11d 


contents to a sequential file. 


Notes 
All activity of the relevant product must be stopped before this utility is run. For 
example, if the file being processed is a CONTROL-D file, all CONTROL-D monitors 
should be down when running this utility. 


UtilityIOADUL cannot be run on CONTROL-B files. 


This utility is typically run1 when an IOA Access Method file is migrated to another DASD 


volume. In this case, the following ar:e performed: 


1. Utility IOADUL is run to unload the IOA Access Method file data component's recovds to a 
sequential, dataset. 


2; A new IOA Access Method file is allocated on a new DASD volume. 


3: This new IOA Access Method.file is formatted using utility IOADBF. 


4. Utility IOADLD is executed to, reload, the IOA Access Method file data component reco11ds 


from the sequential dataset previously produced by IOADUL. 


5 .. Utility the appropriate index rebuilding utility (e.g., CTDDIB for CONTROL-D files) is 
executed to. rebuild the IOA Access Method file index component based on• the data 
component's record contents. 


Activating the Utility 


//UNLOAD· 


Parameters 


EXEC 
ZOADUL,DBFZLE=filename,SQFZLE=seqfilename,RBAOFF=offfset 


[, FROMKEY=fkey] [TOKEY=tkey]' 


The following parameters can be specified to the utility in the EXEC statement which 


invokes the IOADUL JCL procedure. 


DBFILE 


SQFILE 


RBAOFF 


FROMKEY 


TO KEY 


Input IOA Access Method file's dataset name suffix. 


Output sequential file's dataset name suffix. 


RBA offset in the index record key pointing to the data component 
record. The default setting for this parameter is 0; 


Value of the record key from which to copy. Optional. 


Value of the record key until which to copy. OptionaL 


If FROMKEY and TOKEY parameters are not specified 011 are specified as blank, all 
records are copied. 
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Example 


//UNLOAD 
EXEC 


IOADUL 


IOADUL,DBFILE=PRM,SQFILE=PRMSEQ 


Refer to sample job CTDUFDUL in the CONTROL-D JCL lib~ary for an example of how to 
unload a IOA Access Method file data component to a sequential dataset. 


Note 
For a full list of the files this utility· supports, see "The JOA Access Method" in Section 2 · 


of this guide; 
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IOALDNRS - Load Manual Conditions File 


This utility creates and loads the Manual Conditions file which can be viewed via the IOA 


Manual Conditions screen described in Section' 2 of the IOA product-specific user manuals. 
The utility is usually run: every day after the New Day pJJocedure finishes executing. 


To identify conditions which: should be placed in the Manual Conditions file, the utility 
first perfoJJms a search for all pJJerequisite IN conditions required for the submission of 
jobs/missions/repoJJts on the particular day. The search for prerequsite IN conditions is 
performed by checking the job scheduling definitions of all jobs in the Active Jobs file and 
by checking the mission definitions of missions in the Active Missions file. 


Once the prerequisite IN conditions have been identified, the utility eliminates 


non~manual conditions from the list to arrive at the list of manual conditions which1 need 
loading. A pJJerequisite IN condition is not included in1 the Manual Conditions file if it 
satisfies either of the following criteria: 


• The prerequisite condition is add~d to the IOA Conditions/Resources file by an ONT or 


DO COND statement in1ajob/mission/report which is active that day. 


• The prerequisite condition1 already exists in1 the IOA Conditions/Resowces file. 


All prerequisite IN conditions which do not meet the above criteria are assumed to be 
manual conditions and are placed in the Manual Conditions list. 


Through parameters passed to the utility, it is possible to exclude the Active Jobs file 


and/oJJ the Active Missions file from the search foJJ manual conditions .. Of course, if both 
files are excluded, no' manual conditions will be found,. even if they exist. 


Every time the utility is activated, the Manual Conditions file is re-created and all 
previous conditions are automatically deleted' from the file. It is possible to override this 
default by using parameter ADDMODE. 


This utility can' be used in conjunction1 with KeyStroke Language utility ADDMNCND. 
(Refer to "Maybe Jobs" in Section 6 of the CONTROL-M User Manual fov details.) 


The conditions to be included in the file can be limited by control statements supplied via 
DD statement DALNRIN (or SYSIN). 


Parameters 


IGNORE 
Indicates conditions to be ignored during the building of: the Manual 
Conditions file. Valid values are: 


IN pJJefix 


OUT prefix 


All 
1 conditions beginning with the specified prefix are 
ignored when, the file is created~ 


Any reference (i.e., additions) to the condition whose 


pJJefix is defined in the IGNORE statement appearing 
in production parameter OUT are ignored by the 
algorithm used:to·build the Manual Conditions file .. An 
asterisk (*) signifies that alli OUT parameters are 
ignored. 
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CONTROLM 


CONTROLD 


ADDMODE 


CODES prefix 


WHEN prefui . 


CTMSTATUS 
ENDED 


CTDSTATUS 


ENDED 


IOALDNRS 


Any reference (i~e.,. additions) to a condition' whose 
prefix is defined in the IGNORE statement appearing 


in production parameter DO COND are ignored by the 
algorithm used to· build the Manual Conditions file. An 


asterisk (*) signifies that all DO COND parameters are 


ignored, 


Any reference (Le., additions) to the condition whose 


p11efix is defined· in the IGNORE statement appearing 


in parameter WHEN DO COND is ignored by the 
algorithm which is used 
1 to build the Manual, Conditions 
file. An asterisk (*) signifies that all WHEN DO COND 
pwameters are ignored. 


Manual conditions for jobs in the Active Jobs file which, 


have finished executing (ended OK or NOTOK) are 


ignored by the algorithm used to build the Manual: 
Conditions file. If this parameter is used, parameter 


CONTROLM must be set to YES. 


Manual' conditions for missions in the Active Missions 
file which have finished. executing (ended OK or 


NOTOK) are ignored by the algorithm: used to build the 
Manual Conditions file. If this parameter is used, 
parameter CONTROLD must be set to YES. 


Determines whether or not information in the CONTROL-M Active 
Jobs file should be used in the calculation which builds the Manual 
Conditions list. Optional. Default taken from installation parameters. 


YES 


NO 


Include CONTROL-M information in the calculation 


whichi builds the Manual: Conditions file. 


Build 
the 
Manual: 
Condition 
file 
based 
on 


CONTROL-DN information only. 


Determines whether or not information in the CONTROL-M Active 
Missions file should be used in the calculation which builds the 
Manual Conditions file. Optional. Default taken from: installation 
parameters. 


YES 


NO 


Include CONTROL-D information' in the calculation 
which builds the Manual Conditions file. 


Build 
the 
Manual 
Conditions 
file 
based 
on 
CONTROL-Minformation only. 


If this parameter is specified, when the existing Manual Conditions 
file is deleted, only manual conditions from that file which were added 
(via. the ADD command) to the IOA Conditions/Resources file are 
retained and appear in the new Manual Conditions file. 


Note 
When CONTROL-Mand CONTROL-DN are both active, it is recommended that a 
shared control parameters member be used~ 
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Activating the Utility (and Example) 


I I EXEC J:OALDNRS 


llDALNR:CN DD * 


:CGNORE J:N CJ:CS 


:IGNORE J:N :IMS 


:IGNORE 00~ DB-FJ:LE 


:IGNORE CODES DB•FJ:LE 


CON'l'ROLM YES 


Return Codes 


0 


4 


8 


Ope11ation, pe:rfo11med successfully 


File is full; no mo11e space to add conditions 


Critical erro11, list not created 
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IOANOTE - Write a Message to the IOA Log File 


This utility writes a message to the IOA Log file. It can be imvoked as a started task (STC) 
or as a job step. 


On terminals supporting color, messages written by lOANOTE appear on the Log screen in 
a different color than' other messages, making them more readily identifiable. 


The message to, be written to the Log file is specified via parameter PARM. 


Parameters 


PARM 
Text of the message to be written• 


Activating the Utility 


As ajob step: 


II EXEC XOANOTE,PARM=text 


As a started task: 


S XOANOTE,PARM='text' 


Return Codes 


Operation performed successfully 
0 


4 


8 


No· parameters passed to, utility program 


Operation failed 


Example 


II EXEC XOANOTE,PARM='PAYROLL APPLZCATXON MESSAGES BEGXN HERE' 
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IOATEST · Simulate Production Environment Events 


This utility simulates various events in the production environment. For example, it can 
simulate step termination' codes or cause the step to "wait" a specified interval. 


Parameters 


CMD 


WTO 


WTOR 


WTOM 


ROUT 


DESC 


CONID 


DEFDELAY 


WAIT 


TERM=Cnnn 


TERM=Unnnn1 


TERM=Snnn 


Issue an operator command. The command can be either an MVS/JES 
command or, when MVS is running under VM, a CP command. (CP 


commands must start with cha11acters CP.) Maximum text length= 76 
characters. 


Write message to operator console. Maximum text length = 76 
characters. 


Write message to! operator console with repl;y. Maximum text length= 
75 characters. 


Issue multi-line message. major is the p11imary message line. 


Subsequent mino11 lines are secondary message lines, delimited, by a 
+++ line. A maximum of ten' message lines are permitted. 


Example 


WTOM= major 
minorl 
minor2 
minor n 


+++ 


Valid route code from 0 to 16 (O = no route code). Default:. all route 
codes. 


Valid descriptor code from 0 to 16. Default: 0 (none). 


Console ID to which the message is issued. Valid range: 0-999. 


Default: 0. 


where n = number of 1/100 seconds. The program waits for a given 
time both before a WTO/WTOR/WTOM message 011 command is 
executed, and befo:r~e the p11ogram ends. 1-4 digits .. Default: 100 (one 
second). 


Cause the step to wait n seconds. Valid 
1 range: 0·999. 


Condition code to be simulated. Valid range: 0~4095. 


User abend code to be simulated. Valid range: 0-4095. 


System abend code to be simulated. Valid hexadecimal range: 


ooo~FFF. 
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WTO, ROUT, DESC, CONID, CMD, WAIT, and TERM can also be specified in the PARM 
keyword of the EXEC job step. If this method is used~ only the PARM parameters are 
executed in the following order: WTO, WAIT, TERM. When using PARM, DEFDELAY is 
always 0: 


Examples 


//EXEC J:OATEST, 
II PARM='WTO=PROGRAM ERROR,WAJ:T=101TERM=U0008 1 


Issues WTO message with the text "PROGRAM ERROR", waits 10 seconds, and terminates 
the step. with user abend U0008. 
II EXEC J:OATEST 


//SYSI.N DD * 


CMD=D T 


TERM=C0004 
II 


Issues the operator command 'D T', and then' terminates with condition 1 code C0004. 
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IOA VERFY - Verify IOA File Installation and Status 


Utility IOAVERFY verifies IOA pvoduct installation and produces repovts on the 
utilization of various IOA files. 


The actions performed by the utility depend on' the input statements specified. The 
following input statements can be specified, each with its own parameters: 


DISPl'..AY 


VERIFY 


Controls the scope of display. Optional. Multiple DISPLAY statements 
can be specified. A DISPLAY statement is in effect until the next 
display statement. Valid parameters for this statement are: 


ALL 


ERROR 


Both information and errors are displayed. Default. 


Only error messages and warning messages ave displayed, 


Displays and verifies information. about the requested item(s). 
Optional, but at least one VERIFY or LIST statement should be 
specified ov there will be no utility output. Multiple VERIFY 


statements can be specified .. A VERIFY statement remains in effect 
until the next VERIFY statement is specified. 


Valid formats fo:v a VERIFY statement are: 


VER:CFY SYSTEM GENERAL· 


Displays 
general 
information 
about 
the 
system 
environment. 


VER:CFY PASSWORD 


Displays CPU identification infovmation. 


VER:CFY F:CLE filebype 


Where: 


file type 


ALL 


CKP/AJF 
AMF 


RES 


NRS 


LOG 


Indicates files to be diSplayed and verified in this run of 
utility IOAVERFY. Valid values for filetype are: 


Includes all files listed below. 


CONTROL-MActive Jobs file. 


CONTROL..-D Active Missions file. 


IOA Conditions/Resources file. 


IOA Manual Conditions file. 


IOA Log file .. 


Notes 
CKP and AJF are two names for the same CONTROL-M file. 
Both names are supported. 


If VERIFY FILE ALL is specified, the program determines which 
products are installed, and displays information on all relevant 
filetypes. 
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LIST 


END 


IOAVERFY 


Displays subsystem control blocks and IOA parameter tables. This 
statement 
helps 
IOA 
suppo11t 
personnel 
during 
problem 


determination• Optional~ but at least one VERIFY 011 LIST statement 
should be specified or there will be no utility output. Multiple LIST 
statements can1 be specified. A LIST statement remains in effect until 


the next LIST statement is specified. 


Valid formats for a LIST statement are: 


LIST PA.BM parmname 


or 


LIST SUBSYS subsys~name 


Where: 


parmname 
Names of parameter tables to be displayed. 


ALL 
Snapshot dumps of parameter tables for all 


IOA p11oducts installed 


CTBPARM 
Snapshot dump of module CTBPARM 


CTDPARM 
Snapshot dump o£module CTDPARM 


CTMPARM 
Snapshot dump of module CTMPARM 


CTOPARM 
Snapshot dump of module CTOPARM 


CTTPARM 


CTVPARM 


CTRPARM 


Snapshot dump of module CTTP ARM 


Snapshot dump of module CTVPARM 


Snapshot dump of module CTRP ARM 


ECSP ARM 
Snapshot dump of module ECSP ARM 


IOAP ARM 
Snapshot dump of module IOAP ARM 


IOAXPARM 
Snapshot dump of module IOAXPARM 


subsys-name Name of subsystem whose control blocks are to be 
displayed. Optional• If omitted, the subsystem name 
specified in' member IOAPARM is used. A snapshot dump 
is taken of all the data areas relating to the subsystem •. 


Terminates input to the utility. Optional. Only one END statement 
can be specified, at the end of the utility statements. 


Activating the Utility 


//VERIFY 
EXEC IOAVERFY 


I /DAVRFIN DD * 


Return Codes 


0 


4 


8 and above 
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Operation' perfo11med1 successfully 


Warning message 


Severe error found, 
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CON,TROL-M Utilities 


CTMBGRP - Convert Regular Scheduling Tables to Group 
Scheduling Tables 


Utility CTMBGRP automatically converts regular scheduling tables into Group scheduling 
tables. 


During conversion from a regular scheduling table to a Group table, the following actions 
are automatically performed by the utility: 


• Entity is created fo11 the table. 


• A Group name is defined· and added (in, protected mode) to the GROl:JP field in' each job 
scheduling definition' 


• The format of the regular job scheduling definitions is modified to match the format of job 
scheduling definitions in· Group scheduling tables (i.e., the SCHEDlJLE TAG field is added 
to, and suppoJ.lted in, the job scheduling definitions). 


Note 
Compress jobs within a table (i.e., job scheduling definitions with the MINIMUM 


and PDS fields defined) are converted, but these jobs are not assigned SCHEDULE 


TAG fields; Instead, their only scheduling criteria after the conversion are the 
MINIMUM and PDS criteria; However, a SCHEDULE TAG field can be manually 
added following conversion. 


Statements. and Parameters 


• All utility messages are writtento·the SYSPRJNT file. 


• The START/END conversion' messages are also written to the JOA Log file. 


• Parameters are passed to the utility via DI:> statement SYSJN. 


Therefo11e, the datasets referenced by the following DD statements should be specified: 


DALOG 


SYSPRJNT 


SYS JN 


References the JOA Log file. 


References the utility message file. This file can be a SYSOUT 


file. 


References the utility input file. 


Keywo11ds in· the SYSJN statements must be specified beginning in column 1 and in1 the exact 
sequence indicated .. Lines with an· asterisk(*) in column 1 are treated as a comment line. 


Parameters required for the conversion, are: 


JN-T ABLE=old-table 
Old (regular) scheduling table member 


OUT-TABLE=new-table New (Group) scheduling table member 


GROl:JP=group~name 
Group name (1 - 20 in length) to be assigned to the jobs in the 
scheduling table. 
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Multiple tables can be converted in a single run of the utility by passing multiple pairs of 
IN/OUT/GROUP lines. These pairs can: be separated by a comment line. 


Note 
The value assigned to OUT-TABLE cannot be identical to value of IN-TABLE. 


Activating the Utility (and Example) 


The following sample job to activate the utility can be found in member CTMBGRP in the 


CTM.JCL library: 


I I 
JOB CARD PABAME'l'ERS • 


llBUICLD1 
EXEC PGM=C'l'MGRB>REG:CON=OM 


llSTEPL:CB 
DD D:CSP=SHR,DSN=:COA.'Vmm.LOAD 


llDALOG 
DD D:CSP=SHR,DSN=:COA.'Vmm. 


*----------------------------------------* 
* 
F:CRST TABLE. 
* 
*----------------------------------------* 


:CN-'l'ABLE=OLD. DSN ( OLD'l'ABLE) 


OUT-'l'ABLE=NEW.DSN(NEW'l'ABLE) 


GROUP=NEW-GROUP-NAME 


*----------------------------------------* 
* 
SECOND TABLE. 
* 
*----------------------------------------* 


:CN-'l'ABLE=OLD.DSN2(0LDTAB2) 


OUT-'l'ABLE=NEW.DSN2(NEW'l'AB2) 


GROUP=NEW-GROUP-NAME-2 


*----------------------------------------* 
* 
'l'H:CRD TABLE, E'l'C, 
* 
*----------------------------------------* 


Return Codes 


0 


4 


All scheduling tables were successfully converted 


8 


16 


20 
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All scheduling tables were successfully converted) but at least one of 


the tables contained at least one compress job, Compress jobs were not 
assigned SCHEDULE TAG fields during conversion 


At least one table was not converted due to error. An error message 


identif~ng the unconverted table, and the error, was issued for each 
unconverted job 


Initialiiz;ation: failed. No tables were converted. A message indicating 
the error was issued 


Insufficient memory. No, tables were converted 
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CTMCAJF - Maintain the Active Jobs File 


Utility CTMCAJF performs special maintenance functions on1 the Active Jobs file. The 
operator is warned in advance when the Active Jobs file is nearly full. The operator can 
use utility CTMCAJF to· perform any of the folltiwing actions: 


• Compress the file. 


• Clean unwanted entries from the Status screen. 


• Change the size of the file by copying the file to a different size file .. 


Statements and Parameters 


The utility receives parameters, which designate the required function, via DD statement 


DACOPPRM (or SYSIN). Any o:Hhe following functions can be requested: 


COMPRESS 


CLEANUP 


COPY 


Makes room in the Active Jobs file by physically deleting all jobs 
marked DELETED or ENDED OK. 


frees space in the Active Jobs file by logically deleting all: jobs marked 
DELETED or ENDED OK. Although, these jobs remain, in the Active 


Jobs file untilthe New Day procedure is run, the space they occupy in1 


the file can be overwritten by new information, 


Copies the Active Jobs file to a different size file, generally a larger file 
which effectively increases the size of the Active Jobs file. 


Notes 
The COMPRESS and COPY {Unctions cannot run in parallel 
to·the CONTROL-M monitor. If the monitor is not shut down, 
the utility·will terminate; Online users may·remain logged on. 


The CLEAN {Unction must run simultaneously· with the 


CONTROL-M monitor. Do not shut down the monitor when 
running the utility· with this {Unction. 


IGNORE/SELECT Statements 


IGNORE/SELECT statements are optional and can only be specified for COMPRESS and 


CLEANUP functions. They identify jobs which should be deleted or not deleted, as follows: 


IGNORE statements 
Identify jobs which should: not be deleted. 


SELECT statements 
Identify jobs which should be deleted. 


Note 
If a CLEANUP is being performed, IGNORE/SELECT statements are applied in 
addition to (not instead of) the default IGNORE I SELECT statements specified in the 
New Day procedure. New Day procedure default IGNORE I SELECT statements are 
applied by this utility. 


Up to 500 IGNORE/SELECT statements can be specified. Jobs are handled according to 
the first statement for which the criteria are met. 
· 
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One 011 mo11e of the following parameters may be specified in any IGNORE/SELECT 


statement (in any order): 


GROUP groupname 
Name of the group appearing in the job scheduling definition. 


JOB NAME jobname/ 
jobname 
Job name appearing in both the job statement and 
the JOB NAME field of the Status screen~ 
MEMBER membername 


STATUS status 


FROM date 


TO date 


membername Job, scheduling definition name (name of the JCL 


file). 


jobname or membername (but not both) can, be specified in, one 
statement. 


Specify one of the foUowing job statuses: 


ENDOK 


ENDNOTOK 


HELD 


WAITSCHED 


Starting ODATE in' yymmdd format 


Ending ODATE in, yymmdd format 


Note 
A prefix can be specified instead of a fUll group name, job. 
name or member name by placing an asterisk(*) at the end 
of the string (e.g.,.PROD*). 


Specifying AutoEdit Variables and Functions 


AutoEdit variables can' be specified for any of the above parameters. These variables are 
especially useful for specifying relative date ranges in' the FROM and TO parameters. 


AutoEdit functions can, be used to set variables and these variables can then be used in the 
parameters of the utility. The lines in' which the variables are set must have an' asterisk 
(*) in the first column of the line. Such lines are resolved by the AutoEdit facility, and are 
interpreted as comments by the utility. Regular comments can also be specified in lines 


with an' asterisk in' the first column~ 


Example 


* 
IGNORE MEMBERS PREFIXED WJ:TH BR14 WH:CCH WERE ORDERED 
* 
WITHIN THE LAST THREE DAYS. 


* 
%%SET %%F = %%CALCDATE %%DATE -3 


IGNORE MEMBER BR14* 


Note 
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FROM %%F 


The following AutoEdit terms cannot be used in the input for this utility: 
%%0DATE, %%0YEAR, %%0MONTH, %%ODAY, %%0WDAY, %%INCLIB, and 


%%INCMEM. 
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File Statements 


File statements are mandatory for COPY functions. They cannot be specified for COMPRESS 
or CLEANUP functions. The follbwing pa11ameters must be specified for COPY functions: 


OLDAJF 


NEWAJF 


Name of the old Active Jobs file 


Name of the new Active Jobs file 


Compressing the Active Jobs File 


The Active Jobs file o£ten contains entries for jobs which are no longer needed (jobs with a 
status of DELETED or ENDED OK). Compression makes room in' the Active Jobs file by 
physically removing these unneeded entries from the file. Removed entries no, longer 
appear on1 the Status screen. 


Cleaning the Active Jobs File 


Normally, the Active Jobs file is cleaned (i.e., unneededjob entries are deleted) once a day 
by the New Day procedure. By default, all jobs with status END@K which are not being 
held are deleted during this cleanup. The defaults can be overridden by using SELECT 


and IGNORE statements (which select or ignore jobs for deletion). 


Utility CTMCAJF can be run, as often1 as necessary to clean, the Active Jobs file. 


Unlike the cleanup performed by the New Day procedure, utility CTMCAJF does not 
actually delete the unneeded jobs. Instead, it marks the job entries as deleted so that they 
are ignored by CONTROL-M and so that, by default, the job entries do not appear in the 
Status screen. (To display these logically deletedjobs in the Status screen, specify Yin the 
DELETED field in the Show Option Window of the Status screen.) 


These jobs will be physically deleted the next time the New Day procedure is run,, 


When: utility CTMCAJF is run to, clean up the Active Jobs file, it applies the cleanup criteria of 
the New Day procedure in addition to the cleanup criteria specified with the utility. If the 
cleanup criteria of the New Day procedure are not desired when running utility CTMCAJF, 


they should be overridden by SELECT/IGNORE statements specified in, the utility. 


Changing the Size of the Active Jobs File 


Note 
Online users should not access the CONTROL-M Online facility while the size of the 
Active Jobs file is being changed~ 


To change the size of the CONTROL-MActive Jobs file, perform the following steps: 


1. Change CONTROL-M installation parameter CKPSIZE in, member CTMPARM to the 
required new Active Jobs file size. 


Note 
After step 2, every access to the Active Jobs file (Online, batch, or monitor) will try to 
utilize the new size and may·abend; Therefore, all access to the Active Jobs file should 
be stopped, and the monitor should be shut down until the process is complete. 


2: Reassemble member CTMP ARM using job ·CTMP ARMJ. 


3. Change parameter CKPSIZE in procedure CTMFRCKP to the new size of the Active Jobs file. 
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4. Run member FORMCKP in the IOA INSTCTM library after changing the dataset names (to 
avoidoverridingthe existing Active Jobs file and its backup file). 


5. If you have a backup file, allocate a new backup file and run member FORMCKP against 
the new backup file. If you are working in dual, checkpoint mode, run member FORMDCKP. 


Note 
If you are working in dual checkpoint mode, the Mirror file must also· be allocated 
with the new size before starting the CONTROL-M monitor. Otherwise, an abend of 
the CONTROL-M monitor mayoccur. 


6. Run utility CTMCAJF. The utility copies the cuxrent Active Jobs file to the new Active Jobs file. 


7. Rename the old Active Jobs file (and its backup file - suffix BKP). 


8. Rename the new Active Jobs file (and its backup file - suffix BKP) to the former names of 
the old files. 


9. Restam the CONTROL-M monito11 and resume operation~ The utility must terminate with a 
return code of 0. 


Activating the COMPRESS Function 


//CO'MP 


II 


EXEC C'l'MCAJF 


CO'MPRESS 


Activating the CLEANUP Function 


//CLEANUP EXEC C'l'MCAJF 


CLEANUP 
II 


Activating the COPY Function (and Example) 


//COPY EXEC C'l'MCAJF, 
II 
II 


COPY 


OLDAJF='C'l'M.PROD.CKP', 


NEWAJF='C'l'M.PROD.NEWCKP' 


OLD ACTJ:VE JOBS FZLE 


NEW ACTJ:VE JOBS FZLE 


II 


Return Codes 


0 


other 


Examples 


Operation' performed successfully 


Operation failed 


//CO'MP EXEC C'l'MCAJF 


CO'MPRESS 


ZGNORE STA'l'US WAZTSCHED 


SELECT GROUP NZGHT-BATCH 


In' the above example, all jobs fromi the night batch, except those with a WAIT SCHEDBLE 


status, are deleted. 
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CTMJSA - Job Statistics Accumulation 


General 


To use the Simulation and Forecasting facility the job's statistical data must be 
periodically retrieved from statistical messages in the IOA Log and placed and 
accumulated in' a special statistical data file called the CONTROL-M Job Execution 


Statistics file. This is done using utility CTMJSA. 


Parameters 


FROMDATE 


TO DATE 


OD ATE 


Date from which statistical data are accumulated from the Log. The 
date can be a specific date (in mmddyy, ddmmyy, or yymmdd format, 
depending on· the site standard), or the date can be a relative negative 
number 0£ days from the date defined by the ODATE parameter. 


Date up to which statistical data are accumulated from the Log. 


Original date (for reference by relative FROMDATE/TODATE 
parameters). 


Activating the Utility 


It is highly recommended that the utility be activated periodically, for example, once a 
day, or once a week. The following is an example of a daily accumulation: 


I ID4JSA JOB ••• 
II EXEC CTMJSA 


II 


ODATE %%0MONTH.%%0DAY.%%OYEAR 


FROMDATE -3 


TODATE -1 


The statistical accumulation for the above example will always wo:vk on· jobs which have 
executed from three days ago until the day before today. There is no danger that the same 


job~s data will be accumulated twice. 


Note 
The above sample job contains AutoEdit variables and must therefore be submitted 
directly by CONTROL-M. 


CONTROb-M accumulates data for up to 20 successful runs 0£ a job •. If a job finished 
executing NOTOK, or has been queued for re-execution by a $EJ command, its statistical 
data is not accumulated. 
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CONTROL-B Utilities 


CTBABI - Initialize Active Balancing File 


Utility CTBABI initializes both the Active Balancing file and its backup file, ABFBKP. 
Utility CTBABl should be activated whenever these files are reformatted by utility 
IOADBF. 


Parameters 


The following parameter must be specified in the EXEC statement which invokes the 


CTBABI JCL p11ocedure. 


DBFILEB 
Name of:the file to initialize 


Active Balancing file 
ABF 


ABFBKP 
Backup file ABFBKP of the Active Balancing file 


Activating the Utility 


II 
EXEC CTBABI 


Return Codes 


0 


other 


Example 


Operation, successful 


Operation failed 


II 
EXEC CTBABI,DBFILEB=ABF 


This utility is used by jobs CREFABF and CREFBKP when these files are created at time 
of installation. See these jobs for additional examples. 
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CTBCMP - Compile Rule Definitions 


Utility CTBCMP checks the syntax of rule definitions. It is especially useful for checking 
rule definitions created via a standard editor. 


Parameters 


Parm='-irulename' 


Name of the rule definition which must be checked for syntax errors. The rule name is 
preceded by the -i prefix (which can be uppercase or lowercase). The rule name and the -i 


p11efix must be specified between, quotes. 


Activating the Utility 


II 
EXEC C'l'BCMP,PARM='-J:RtmENAME' 


Return Codes 


0 


other 


Example 


No syntax errovs were found 


Syntax erro11s were found 


II 
EXEC C'l'BCMP1PARM= 1 -J:COMP'l'O'l'S 1 


llDABRULDD DJ:SP=SHR,DSN=C'l'B.PROD.RULES 
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CTBDBIB - Rebuild a CONTROL-B Index File 


Utility CTBDBIB rebuilds index files for various CONTROL-B data files. The new index 
files correspond to information' contained in the data files. 


This utility rebuilds the indexes of a specific data file. Previous contents of the index file 
are erased. 


Note 
The index file that is to be rebuilt must be allocated and formatted pnior to activating 
the utility. 


This utility should be used: 


• When, the space remaining for the existing index file is insufficient. In this case: 


-Delete the index file. 


- Redefine the index file withthe required amount of space. 


-Format the index file withutility IOADBF. 


- Rebuild the index file with utility CTBDBIB. 


• In, case of index file integrity problems: index file integrity problems can be detected using 
utility CTBDBII, which is described later in this section. 


• In, case of data file integrity problems:. correct the data file and reindex it with utility 
CTBDBIB to reproduce the corresponding index file; 


Parameter 


The following parameter can be specified in, the EXEC statement which invokes the 
CTBDBIB JCL procedure .. 


DB FILE 
Name of data file to be processed. 


Note 
SYSIN parameters. are provided in the keyxxx members. in the P .AJlM library· for your 
convenience. File name specifications are hard-coded (pnedefined) in these members. 


Activating the Utility 
II EXEC CTBDB:CB 


Return Codes 


0 


other 
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Operation performed successfully 


Operation' failed 
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Example 


II 
EXEC C'l'BDB:CB:.DBF:ILE=GRPD' 


llSYS:CN 
DD 
DSN=C'l'B.PROD.PARM(KEYGRP),D:CSP=SHR 


llDAGRP 
DD 
DSN=C'l'B.PROD.GRP:t,D:CSP=SHR 


Utility CTBDBIB is used by the following jobs in' the JCL library. Refer to these jobs for 


additional examples:. 


JOBBDBM 


JOBBDBV 


JOBBGRP 


JOBBJAF 


JOBBREP 


Rebuilds the index o£the Database Variable Basic file. 


Rebuilds the index of the·Generationfile. 


Rebuilds the index of the Group file. 


Rebuilds the index of the Rule·Activity file. 


Rebuilds the index of the Report file. 
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CTBDBVCG ·Change Number of Variable Generations 


This utility changes the maximum number 0:£ generations specified for one ov move 


Database Variables. It is useful, whenever the number of generations must be changed but 
is most often used when changing the status (mode) of variables from test to production. 
The utility can be invoked in batch mode as described in' "Activating the Utility." 


The number of generations to be retained in' the database can be increased or decreased. 
The content 0:£ existing variable generations can be retained ov deleted. All other relevant 
aspects 0:£ the variable(s) ave retained, including definitions and group information. 


It is possible to change the number of generations of all variables, groups of variables 
(with. a common group name prefix), or one or more variables of the same group (with a 
common' variable name pvefix) in, one activation of utility CTBDVCG. 


Parameters 


The following parameters can, be specified in the EXEC statement which invokes the 


CTBDBVCG JCL p11ocedure. These parameters dynamically specify source (input) file 
names and indicate whether the current content of existing generations should be retained 
or deleted. 


DIMOB 


DIVAR 


DIG RP 


COPY 


Prefix 0£ the third qualifier 0£ the name 0:£ the source (input) Database 
Variable Basic Data file. 


Prefix of the third qualifier of the name of the source (input) Database 
Variable Generation Data file. 


Prefix of the third, qualifier of the name 0:£ the source (input) Group file. 


YES 


NO 


Retain current contents of existing generations. 
Default. 


Delete current contents, if any, 
0:£ existing 
generations. 


Pai;ameters are also supplied via DD statement SYSIN. The follbwing parameters are 


mandatovy: 


GRO"CJP 
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Group name (or p11efix) of variables to be affected. A group name 
prefix can be specified only if parameter VARIABLE contains an 
asterisk (*). 


Example 


GROUP=INV 


GROUP:::INV* 


V alliables of group INV are changed. 


Valliables 0:£ all groups that begin with INV (e.g., 
INV,INVENTORY, INVESTMENTS) are changed, 


To change the number of variables for all groups, the SYSIN input file 
should be empty (and no GROUP or VARIABLE names should be 
specified). 
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Note 
Parameter GROUP may be specified only if an asterisk (*) was 
specified in parameter VAR1ABLE. 


Variable name (or p11efix) of variable(s) whose number of generations 
should be changed. 


Examples 


GROOP=:CNV 
VAR:CABLE=TOT 


Variable TOT of group INV is changed. 


GROOP=:CNV 
Variables 
of 
group 
INV 
that 
begin 
with 


TOTVAR:cABLE=TOT* 
TOT (e.g., TOT, TOTAL, TOTOl, TOT02) are 
changed. 


New number of generations to be specified fo11 the variable. If not 
specified, NUMGEN is set to the default number of generations in 


SystemVariable SYSDBVARGENS. 


Activating the Utility 


II 
EXEC 
CTBDBVCG,D:IMOD=mod,DJ:VAR=var,D:CGRP=grp,COPY=yeslno 


llSYS:CN 
DD * 


GROOP=group 


VAR:cABLE=variable 


NUMGEN=NEW-MAX:CMUM-#-OF-GENERAT:CONS 
II 


Return Codes 


0 


other 


Example 


Operation performed successfully 


Execution erro11, operation failed 


II 
EXEC 
CTBDBVCG,DJ:MOD=MGMT,D:CVAR=ACTG,D:CGRP=TAX,COPY=YES 


llSYS:CN 
DD * 


II 


GROOP=BONDS 


VAR:cABLE=COST* 


NUMGEN=24 
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CTBDBVCP · Copy Variables or Groups to Another File 


This utility copies the contents of specified group/variable files (i.e., data from source files) 
to another set of group/variable files (i.e., target files). All relevant aspects of the variables 
are copied, including definitions, generations, and group· information. 


The sizes of the source and target files may differ. Therefore, utility CTBDBVCP is useful 
for increasing the size of variable files. Usually, this utility copies variables from source 
files to larger target files. 


Copying variables is composed of the following stages: 


• Create and format anew set of group/variable files (tavget files). 


• Copy the data from the source files to the newly-created target group/variable files. 


• Delete the somce files. 


It is possible to copy all variables, groups of variables (with a common group name prefix), 


ov one or more variables of the same group (with a common variable name prefix) in one 
activation of utility CTBDBVCP. 


Parameters 


The following parameters can be specified in the EXEC Statement which invokes the 


CTBDBVCP JCL procedure. These pa11ameters dynamically specify the prefix of the thfrd 


qualifier fo11 the source and destination files listed below: 
. 


DlMOD 


DIVAR 


DIG RP 


DOM OD 


DOVAR 


DOG RP 


REPLACE 


COPY 


Source (input) Database Variable Basic Data file. 


Source (input) Database Variable Generation Data file. 


Source (input) Group file. 


Destination' (output) Database Variable Basic file. 


Destination, (output) Database Variable Generation file. 


Destination (output) Group file. 


Flag which indicates whether 011 not the source variable should 
overwrite an existing variable of the same name in the target. 


YES 


NO 


Target variable should be overwritten. 


Target variable should not be overwritten. 


Flag which indicates whether entire records 011 only variables should 
be copied. 


YES 


NO 


Copy entire records from the Group file .. 


Copy only variables. 


Parameters are also supplied via DD statement SYSIN. The following parameters are 
mandatory: 


GROUP 
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Group name (or prefix) of variables to be copied. A group name prefix 
may be specified only if parameter VARIABLE contains an' *. 
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VARIABLE 


NUMGEN 


FROM GEN 


TO GEN 


Examples 


GROUP=INV 


GROUP=INV* 


Section 9: Utilities 


Variables of group.INV are copied~ 


Variables of all groups that begin with INV (e.g., 
INV, INVENTORY, INVESTMENTS) are copied. 


To copy all groups, the SYSIN input file should be empty (and no 


GROUP or VARIABLE names should be specified). 


Note 
Parameter GROUP may be specified only if '*' was specified in 
parameter VARIABLE. 


Variable name (or prefix) to be copied. 


Examples 


GROUP=INV 
V ARIABLE=TOT 


GROUP=INV 
V ARIABLE=TOT* 


Variable TOT of group INV is copied, 


Variables of group INV that begin with TOT (e.g., 


TOT, TOTAL, TOTOl, TOT02) are copied. 


Number ofi generations to be created for the variable during the copy. 
If not specified, the number matches the source variable's number of 


generations. 


Most recent generation• to copy from the source to the target. If 
FROMGEN is not specified, CONTROL-B begins copying with the 
current (most recent) source generation, 


Oldest generation to copy from: the source to the target. If TOG EN is 
not specified, CONTROL-B begins copying with the current (most 
recent)) source generation. 


Example 


GROUP=J:NV 


VARJ:ABLE=TOT 


NUMGEN=20' 


FROMGEN=S 


TOGEN=10• 


Assume the source variable has at least 10 generations. 


The target va:r~iable can1 have a maximum ofi 20 generations. The first 


six generations of the target variable will contain the values of the 5th 
through 10th generations of the source variable. 


Note 
If no input statement is specified (i.e., the input file is empty), all records from the 
source files are copied~ 
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Activating the Utility 
II EXEC C'l'BDBVCP 


Return Codes 


0 


other 


Example 


Copy operation performed successfully 


Descriptive execution error, copy operation failed 


II 
EXEC CTBDBVCP,DIMOD=MOD,DI:VAR=VAR1DIGRP=GRP1 


I I 
DOMOD='l'ARGMOD, DOVAR='l'ARGVAR, DOGRP='l'ARGGRP · 


//SYS'I.N DD * 


II 


GROUP=CURRENCY 


VAR:rABLE='l'O'l'* 


CTBDBVCP 


Refer to sample member JOBDBVCP in, the JCL libvary for additional information. 


9-64 
JOA ReL 5.0.0 Administrator Guide 


u 


u 


u 


CTBDBVDL 
Section 9: Utilities 


CTBDBVDL - Delete Variables/Groups from Variable/Group 
Files 


Utility CTBDVBDL deletes specified reco!'ds from CONTROL-B Database Variable files. 


Parameters 


The following pa:i:ameters can be specified. in· the EXEC statement which invokes the 


CTBDBVDI:. JCL procedure. These parameters provide dynamic specification of source and 
destination file names: 


DMOB 


DVAR 


DGRP 


DELGR 


Prefix of the third qualifier ofithe name of the Database Variable Basic file. 


Prefix of the third qualifier of the name of the Database Variable 
Generation file. 


Prefix of the third qualifier of the name of the Group file. 


Flag which indicates whether or not the entire group should be 
deleted. 


YES 


NO 


Delete the entire group if no variables exist for this 
group. 


Do not delete the entire group. Default. 


Parameters are also supplied: via DD statement SYSIN: 


GROBP 


VARIABLE 


Group name (or prefix) of variables to be deleted .. A group name pl'efix 
can be specified. only if pal'ameter VARIABLE contains an *. 


Example 


GROUP=J:NV 


GROUP=J:NV* 


Variables of group INV are deleted, 


Variables of aU groups that begin with INV (e.g., INV, 
INVENTORY, INVESTMENTS) are deleted. 


Note 
GROtJP=* cannot be specified. 


Variable name (or prefix) to be deleted. 


Note 
Parameter VAR,JABLE may be specified only if '*' was not 
specified with parameter GROUP. 


Example 


GROUP=J:NV 
VARJ:ABLE=TOT 


Variable TOT.of group INV is deleted .. 


GROUP=J:NV 
Variables of group INV that begin with TOT (e.g.,. TOT, 


VARJ:ABLE=TOT* 
TOTAL, TOTOl, TOT02) are deleted. 
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Activating the Utility 


II EXEC CTBDBVDL 


Return Codes 


0 


other 


Example 


Operation performed successfully 


Operation, failed 


II 
EXEC C'l'BDBVDL,DMOD=MOD,DVAR=VAR1DGRP=GRP,DELGR=YES 


llSYSIN DD * 


II 


GROUP=CURRENCY 


VARIABLE=TOT* 


CTBDBVDL 


Refer to sample member JOBDBVDL in the JCL library for additional information. 
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CTBDBVIG - Check the Integrity of Variable/Group Files 


Utility CTBDBVIG checks the integrity of the Database Variable Basic and Generation 
files. The utility reports errors which are detected in the logical organization, of these files. 
If indicated, CTBDBVIG co11rects errors that are detected~ file integrity errors are listed in 
the sysout of the job; 


Parameter 


The following parameter can: be specified in the EXEC statement which invokes the 


CTBDBVIG JCL procedure: 


ACT 
Flag which indicates whether or not integrity errors should be 
corrected. 


R 
w 


Report erro11s, but do not correct them, Default. 


Report erro11s and correct them' 


Notes 
Index file integrity is not checked~ Therefore, after running utility CTBDBVIG, run 
jobs JOBBDBM and JOBBDBV to rebuild the index files according to the corrected 
state of the data file. 


It is recommended that utility CTBDBVIG first be run without requesting 
corrections (ACT=R). 


Activating the Utility 


II EXEC CTBDBVXG 


Return Codes 


0 


other 


Example 


Operation performed successfully 


Operation failed 


II EXEC CTBDBVXG,ACT=R 
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CTBFRM - Compress the Active Balancing File 


Utility CTBFRM compresses the Active Balancing file. The utility usually runs as part of: 


the New Day procedure befo11e potential missions ave placed as entries in the Active 
Balancing file, but can also be run as a single job, using the FORCE parameter. 


The utility deletes entries from the Active Balancing file which' will no longer be processed 
by CONTROL-B. The Active Balancing file is then compressed. 


A backup of the Active Balancing file is created, automatically by this utility. The default 
backup file name· is ABFBKP. 


Parameters 


The following parameters can be specified in the EXEC statement which invokes the 


CTBFRM JCL procedure. 


DBABFB=ABF 
Third qualifier of the Active Balancing file name. 


DBBKPB=ABFBKP Third qualifier of Backup file name. 


FORCE 
Y (Yes) 


N(No) 


Run the utility in the stand alone mode, without checking 
corresponding dates in member CTBDATE in, the 


CONTROL-B PARM library. Refer to the CONTROL-B 


New Day procedure. 


Default value. The utility is run when invoked by the 


CONTROL-B New Day procedure. Default. 


Activating the Utility 
II EXEC C'l'BFRM,PARM='&FORCE' 


Return Codes 


0 


other 


Example 


Operation performed successfully 


Operation, failed 


II EXEC C'l'BFRM,FORCE=N,DBABFB=ABF,DBBKPB=ABFBKP· 


Refer to sample member JOBFRMin 1the JCL libvary for additional information, 
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CTBJAFCP - Copies Entries in Rule Activity/Report Files 


Utility CTBJAFCP copies invocation, and report entries to other Rule Activity and/ov 
Repovt files .. 


Parameters 


FILE 
File to be copied. 


JAF 


REP 


ALL 


Only the Rule Activity file is copied. 


Only the Repovt file is copied, 


Both the Rule Activity file and co:riresponding reports from 
the Report file ave copied. 


The following parameters can be specified in· the EXEC statement which invokes the 


CTBJAFCP JCL procedure: 


DBJAFI 


DB RE PI' 


DBJAFO 


DB RE PO 


Prefix of the third qualifier of the source (input) Rule Activity file 
name. 


Prefix of the third qualifier o£the source (input) Repovt file name .. 


Prefix 0£ the third qualifier of the destination (output) Rule Activity 
file name. 


Prefix of the third qualifier of the destination' (output) Repo11t file 
name. 


The following utility parameters are supplied via DD statement SYSIN. The suffix * is 
permitted at the end 0£ any of these pa:r~ameters .. * repvesents any number of characters 
(including no 1characters). 


INCLUDE/EXCLUDE Statements 


The scope of the copy can be limited by one ov more INCLUDE 011 EXCLUDE statements. 
Each INCLUDE/EXCLUDE statement contains job name pvefixes which limit the entries 


whichi are copied. If one or more INCLUDE statements are specified, only entries specified 
in the INCLUDE statements are copied. If one or more EXCLUDE statements are 
specified, the entries specified in the EXCLUDE statements are not copied. There is an or 
relationship between· multiple INCLUDE statements and between multiple EXCLUDE 


statements. 


Parameter job name can be specified. in INCLUDE/EXCLUDE statements .. This parameter 


repvesents the job name. 


If no:INCLUDE/EXCLUDE cci.teria a11e specified, the entire file is copied .. 


CTBJAFCP parameters can be specified on several lines. In this case, each parameter 
should be listed on a separate line. 


Note 
If no input statement is specified (i.e., the input file is empty), all records from the 
source file are copied. 
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Activating the Utility 


II EXEC CTBJAFCP 


llSYS'I.N DD * 


II 


Return Codes 


CTBJAFCP 


8 


12 


16 


100+ 


Syntax erron in the input parameters stream (SYSIN cards) 


Insufficient memory to, run the utility 


Unable to open a CONTROL-B Database file 


Internal error 


Example 


II EXEC CTBJAFCP1F'I.LE=ALL,DBJAFI=JAF,DBREPI=REP,DBJAFO 


=JAFNEW,DBREPO=REPNEW 


llSYSIN 
DD * 


INCLUDEJOB2* 


EXCIIUDEJOB22 


EXCIIUDE JOB23* 
II 


To copy the files, perfonm the following steps: 


1. Allocate a new set 0£ Rule Activity and Report files via utility CTBCRDF. 


2. Copy the existing files, on a portion o£these files (e.g~, only relatively new invocations), into· 


the new files via utility CTBJAFCP. 


3. Delete the old files. 


4. Rename the new: files to the names of the original files. 


Refer to·sample member JOBJAFCP inthe JCL libnary for additional infonmation, 
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CTBJAFDL - Deletes Entries From Rule Activity/Report 
Files 


Utility CTBJAFDL cleans unnecessary entries from the Rule Activity file and/or the 
Report file. 


Parameters 


The following parameters can be specified in the EXEC statement which invokes the 
CTBJAFDL JCL procedure: 


DBJAFB 


DB RE PB 


PRINT 


Prefix of the third qualifier of the Rule Activity file·name. 


Prefix of the third qualifier of the Report file name. 


Flag which indicates whether or not deleted entries are pllinted. 


PRINT 


NO PRINT 


Information: about deleted entries is printed. 


Information1 about deleted entries is not printed. 


The following parameters are supplied via DD statement SYSIN. The suffix * is permitted 
at the end, of any of these pavameters. * represents any number of characters (including no 
challacters). 


DAYSn 


INCLUDE/ 
EXCLUDE 


If 0 is specified or if DAYS is specified without any accompanying 
subparameters, utility CTBJAFDL operates on all entries in the Rule 
Activity file/Report file. n is the retention: period befolle deletion of 
entries from the Rule Activity file/Report file. n cannot be a negative 
number. To delete all entries, specify DAYS=O. Mandatory. 


The scope of the deletion can, be limited by one Oil molle INCLUDE or 
EXCLUDE 
statements. 
Each 
INCLUDE/EXCLUDE 
statement 
contains job name prefixes which limit the entries which are deleted. 
If one oil more INCLUDE statements are specified, only entries 
specified in the INCLUDE statements are deleted. If one or more 


EXCLUDE statements are specified, the entries specified in the 
EXCLUDE statements are not deleted. There is an, OR relationship 
between multiple INCLUDE statements and: between multiple 


EXCLUDE statements .. 


Parameter JOB NAME can be specified in INCLUDE/EXCLUDE statements. This 
parameter repvesents the job name. 


CTBJAFDL parameters may be specified on: several, lines. In this case, each parameter 
should be listed on a separate line. 
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Activating the Utility 
II EXEC 
CTBJAFDL 


llSYSIN 
DD* 


DAYS n 


[:CNCLUDE {PARAMETERS}] 


[EXCLUDE {PARAMETERS}] 
II 


Return Codes 


0 


other 


Example 


Operation performed successfolly 


Operation failed 


II EXEC CTBJAFDL,DBJAFB=JAF,DBREPB=REP,PR:CNT=PRINT 


llSYSIN DD * 


DAYS· 4 


:CNCLUDE JOB2* 


EXCLUDE JOB22 


EXCLUDE JOB23* 
II 
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CTBJAFIG - Check the Integrity of Rule Activity/Report 
Files 


Utility CTBJAFlG checks the integrity of the Rule Activity and Report files .. The utility 
reports errors detected in the logical organization of these files. If requested, utility 


CTBJAFIG co11rects the erro11s that are detected .. file integrity errors are listed in the 
sysout of the job. 


Parameters 


The following parameters can be specified in the EXEC statement which invokes the 


CTBJAFIG JCL p11ocedure: 


FILE 


c 


File· to. be checked/corrected. 


JAF 
Rule Activity file. Default. 


REP 
Repollt file. 


BTH 
Both of the files (without logical links). 


ALL 
Both the Job Activity and Report files (and their logical 
links). 


Flag to· indicate whether 011 not integrity errors should be co11rected. 


Y (Yes) 


N(No) 


Correction· is requested. 


Correction1 is not requested. Default. 


Notes 
Index file integrity is not checked; Therefore, after running utility 


CTBJAFIG with option C=Y, run jobs JOBBJAF and JOBBREP 


to rebuild the index files based on the corrected data file. 


It is recommended that utility CTBJAFIG first be run without 
requesting correction (C=N). 


Activating the Utility 


II EXEC CTBJAFIG 


Return Codes 


0 


other 


Example 


Operation performed successfully 


Operation failed 


II EXEC CTBJAFIG1FILE=ALL,C=N 


Refer to sample member JOBJAFIG in the JCL library for additional information. 
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CONTROL-DN Utilities 


CTDCAMF - Compress Active Missions File 


This utility can, compress the Active Missions file Oil change its size. 


Message CTDF63W is issued if the Active Missions file is about to become full. Message 


CTD533S is issued if the Active Missions file does become full. There are two solutions: 
Increase the size of the file or compress the file; 


Utility CTDCAMF receives control, parameters via DD statement DACOPPRM (oil SYSIN). 
The parameters designate the required function, (compress or copy). 


Note 
This utilitycannot run simultaneouslywith the CONTROL-D monitor. Results will be 
unpredictable if the monitor is not shut down. Online users can remain logged on. 


Compressing the Active Missions File 


The Active Missions file contains entries for jobs which are no longer required (e.g., 
missions whose status is DELETED or ENDED OK). By removing the unneeded entries 
from the file, utility CTDCAMF pllovides space fo11 new entries. 


Activating the Utility 


//COMP EXEC C'l'DCAMF 


COMPRESS 


II 


Refer to sample job CTDCAMF in the CONTROL-D JCL libllary fo11 an example o£how to 
implement this utility. 


Changing the Size of the Active Missions File 


Note 
Online users·should not access the Online facility while the size of the Active Missions 
file· is being changed; 


Perfo11mi the following steps to change the size of the Active Missions file: 


1. Change CONTROL.-D Installation parameter AMFSIZE in' member CTDPARM to the 
required new Active Missions file· size. Assemble the CONTROL-D Installation parameters. 
From this point on1 every access to the Active Missions file (Online 011 batch) willi use the 
new size and may abend. Therefo11e, it is recommended to stop all access to the Active 
Missions file until the p11ocess is complete. 


2; Change parameter AMFSIZE in p11ocedure CTDFRAMF to the new size of the Active 
Missions file. 
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3. Run member FORMAMF in the IOA INSTCTD library. Change the dataset names so you do 
not override the existing Active Missions file and its backup, file (e.g;, parameter TYPE 
should be changed to NEWNAME). 


4. Run utility CTDCAMF with the following parameters: 


//EXEC CTDCAMF, 
II OLDAMF='CTD.PROD•AMF', OLD ACTJ:VE M:CSS:CONSF:CLE 
II NEWAMF='CTD.PROD•NEWAMF' NEW ACTJ:VE M:CSS:CONS F:CLE 


COPY 
II 


Utility CTDCAMF copies the current Active Missions file to the new Active Missions file. 
The utility must terminate with a return code ofO. 


5. Rename the old Active Missions file (and its backup file - suffix AMB). 


6. Rename the new Active Missions file (and. its backup file - suffix AMB) to the former names 


of the old' files. 


7. Restart the CONTROI:,-D monitor and resume operation, 
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CTDCATF - Compress Active Transfer File 


This utility can comp11ess the Active Transfer file or change its size. 


If the Active Transfer file becomes full, there are two solutions: Increase the size of the file 


011 compress the file. 


Utility CTDCATF receives control parameters via the EXEC statement. The parameters 
designate the requilled function' (comp11ess 011 copy). 


Note 
This utilitycannot run simultaneously with the CONTROL-D monitor. Results will be 
unpnedictable ifthe moniton is not shut down. Online users can remain logged on. 


Compressing the Active Transfer File 


The Active Transfer file contains entries fo11 packets which are no longer required (e.g., 
packets whose status is DELETED 011 TRANSFERRED OK). By removing the unneeded 
entries from the file, utility CTDCATF provides space fo11 new entries. 


Example 


//COMP EXEC CTDCATF 
II 


Changing the Size of the Active Transfer File 


Note 
It is highly recommended that online users do not access the Online facility while the 
size of the Active Transfer file is being changed. 


Perfovm the following steps to change the size·of the Active Transfer file: 


1. Change CONTROL-D installation pavameter ATFBLK in1 member CTDPARM to the 
required new Active Transfer file size. Assemble the CONTROL-D installation' parameters. 
After you do this, every access to the Active Transfer file ( online or batch) will use the new 
size and may abend~. Therefove, it is recommended to stop all access to the Active Transfer 
file until!the process is complete .. 


2 .. Change pavameter ATFSIZE in1procedu11e CTDFRA.TF to the new size o£the Active Transfer 
file. 


3. Run member FORMATF in the IOA INSTCTD lib11ary. Change the dataset names so you 


wiUnot override the existing Active Transfer file and its backup file. 


4. Run 1utility CTDCATF withthe following pavameters: 
II EXEC CTDCATF,P=COPY, 
// INATF='CTD.PROD.ATF', 
OLD ACTIVE TRANSFER FILE 


II OUTATF='CTD.PROD.NEWATF' NEW ACTIVE TRANSFER FILE 


II 
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Utility CTDCATF copies the cUMent Active·Transfer file to the new Active Transfer file. The 
utility must terminate with a return code 0£ o, 


5. Rename the old Active Transfer file (and its backup file - suffix ATB). 


6~ Rename the new Active Transfer file (and. its backup file - suffix ATB) to the former names 


o:Hhe old· files. 


7. Restart the CONTROL-D monitor and resume operation. 
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CTDCA2P - Copy Active User Report File to Permanent 


This utility copies new user/repo11t/job/catego11y entries from the Active User Repo11t List 
file to the Permanent User Repo11t List file. The Permanent User Report List file contains, 
for each user, a list 0£ all the repo11ts which he/she/she may receive at any point in time. 
When a new repo11t is defined, 011 when a user becomes a report recipient (e.g., because 0£ 


new data from the application), this information' is placed in the Active User Report List 
file after decollation,. 


This utility copies new entries from the Active User Report list file to the Permanent User 
Repo11t List file. In this way, the list of repo11ts which the user may get is maintained 
automatically. 


It is recommended that utility CTDCA2P be run on' a daily basis. See "Permanent User 
(Report List) File" in Section 4 of this guide. 


INCLUDE/EXCLUDE Statements 


The scope of the copy can' be limited' by one 011 mo11e INCLUDE or EXCLUDE statements. 


Each INCLUDE/EXCLUDE statement contains parameters which limit the user/report list 
entries which will be copied. See "Record Selection Logic (INCLUDE/EXCLUDE 


Statements)" in this section fo11 info11mation about p11efixing, masking, and the INCLUDE 


and EXCLUDE logic used to determine reco11d selection. 


Parameters in INCLUDE/EXCLUDE Statements 


The parameters which can be specifiedinINCLUDE/EXCLUDE statements are: 


JOB NAME 


USER 


REPNAME 


CATEGORY 


Job name 


User name 


Repo11tname 


Catego11y name 


Activating the Utility 
II EXEC C'l'DCA2P 


[~NCLtJDE (parameters}] 


[EXCLUDE (parameters}] 


The new report entries are assigned the current CONTROL-D working date (not the 
computer date). 


This utility may be run simultaneously with the CONTROL-D monito11. 


Return Codes 


0 


8 
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Operation' performed successfully 


1/0 error, execution stopped 
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Example 1 


II EXEC CTDCA2P 
XNCLUDE REPNAME=PROD-JCL 


The following is the status of: the files befol'e the utility is run: 


Active User Report List File 


--USER-- 
-------REPORT------- 
---JOB-- 
----CATEGORY---- 


ACCTSRCV 
ACCOUNTS-RECEJ:V-REPT 
D4ACCRCV 
QUARTEIUIY 


ACCTSRCV 
ACCOUNTS-RECEIV-REPT 
D4ACCRCV 
WEEKLY 


BRANCH01 
DAXLY-BALANCE-REPORT 
D4DAXLYB 
DAXLY 


BRANCH02 
DAXLY-BALANCE-REPORT 
D4DAXLYB 
MONTHLY 


Permanent User Report List File 


--USER•- 
-------REPORT------- 
---JOB-- 
----CATEGORY---- 


BRANCHOl 
DAXLY-BALANCE-REPORT 
D4DAXLYB 
DAXLY 


BRANCH02 
DAXLY-BALANCE-REPORT 
D4DAXLYB 
MONTHLY 


BRANCHOB 
DAXLY-BALANCE-REPORT 
D4DAXLYB 
DAXLY 


Section 9: Utilities 


The following is the status 0:£ the Permanent User Report List file after the utility is rune 


--USER,_- 
-------REPORT------- 
--JOB-- 
----CATEGORY---- 


01ACCTSRCV 
ACCOUNTS-RECEXV-REPT 
D4ACCRCV 
QUARTERLY 


OlACCTSRCV 
ACCOUNTS-RECEJ:V-REPT 
D4ACCRCV 
WEEKLY 


02BRANCH01 
DAXLY-BALANCE-REPORT 
D4DAXLYB 
DAXLY 


02BRANCH02 
DAXLY-BALANCE-REPORT 
D4DAXLYB 
MONTHLY 


OBBRANCH03 
DAXLY-BALANCE-REPORT 
D4DAXLYB 
DAXLY 


o 1 
These entries were copied fromi the Active User Report List file since they did not exist on 
the Permanent User Report List file. 


02 
These entries were not copied from the Active User Report List file since they already 
existed inthe Permanent User Report List file. 


03 
This entry was not modified, 
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CTDCCU - Delete Unneeded CDAM Files 


This utility identifies CDAM files not referenced by the Active User Report List file (by the 


SYSDATA entries) so that they can be deleted, and optionally deletes them• 


CDAM files created using JCL parameter SUBSYS may not always be decollated. In these 
cases, CTDDELRP does not delete these CDAM files since they are not referenced by the 
Active User Repo11t List file (ACTUSR). This utility identifies/deletes these files. 


Parameters 


DATE 


PREFIX 


SIMULATION 


Date range fo11 selecting CDAM files. Format: fromdate - todate. 
fromdate is mandatory; todate is optional. 


Date is in fo11mat mmddyy, ddmm!YY 011 yymmdd, depending on the 
site standard. todate may not exceed the run date minus one. If 
todate is not specified, it defaults to the specified. fromdate. 


CDAM p11efix. At least one PREFIX command is required. Multiple 
PREFIX commands are supported. 


Whether or not CDAM file should be deleted during the run of: the 
utility. 


YES 
Report on CDAM files to be deleted. Do. not perfo11mi the 


deletion, Default. 


NO 
Report on CDAM files to be· deleted. Perform the deletion~ 


Note 
It is recommended that utility· CTDCCU be run first in 
simulation mode to verify that only the correct files are to be 


deleted; 


VERIFY-IN-HISTORY Whether or not the History User Report file should be searched for 
references to·CDAM files not in, the Active User file. 


YES 
Search the Histoey User Report list file fo11 references to 


CE>AM files not in the Active User file. Issue a message 
that indicates whether or not such references were found~ 


This parameter does not influence the identification' of the 


CDAM files to· be· deleted. 


NO 
Do.not search the History User Report List file. 


Activating the Utility 


I I 
EXEC C'l'DCCU 
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DA'l'E=fromdate [- todate] 


PREFIX=pref ix 


[SIMULATION={YESINO}] 


[VER:CFY-IN-HJ:STORY={YES/NO}] 
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Example I 


In the following example, any CDAM file satisfying all of the following criteria is listed in 
the report but not deleted:. 


• PrefixedCTDRSV. 


• Created August 21- 30, 1995.(USA format). 


• Not referenced by the Active User Report List file. 


• Still on disk. 


II EXEC CTDCCU 


DATE=082196-083096 


PREF:CX=CTDRSV 


Example2 


In the following example, any CDAM file satisfying all' 0£ the following criteria is deleted: 


• Prefixed by CTDRSV or CTDALL. 


• Created 21 - 30 August 1995.(International format). 


• Not referenced by the Active User Report List file .. 


• Still on disk. 


Deleted CDAM files are checked against the History Repol.'t list file. The repol't indicates 
whether or not the deleted CDAM files are referenced in' the History Repo:vt List file .. 


I I 
EXEC CTDCCU• 


DATE=210896-300896 


PREF:CX=CTDRSV 


PREF:CX=CTDALL 


SJ:MULAT:CON=NO 


VERJ:FY-:CN-H:CSTORY=YES 
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CTDCLIDS - Clean History User Report List File 


This utility cleans entries from the History User Report List file .. The History User Repo11t 


List file contains entries describing backed up user reports. Each repol"t has a retention 
period. The utility scans the Histo11y User Report List file for an the reports whose 
retention period has passed (i.e., the backup is no longer needed) and deletes them: from 
the History User Report List file. 


This utility pl"oduces a list of all tapes which are no longer needed and can therefore be 
returned, to the global tape pooh 


MODE Parameter 


This optional parameter in' the EXEC Statement determines whether utility CTDCLHIS is 
run in Production mode 011 Simulation' (Test) mode. If the parameter is not specified, the 
default is Production mode. It is recommended that this utility be run: in, Simulation mode 
prior to being run in Production mode .. 


PROD 


TEST 


The utility runs in Production mode, changing and deleting VSAM 


and' CDAM files which satisfy the requirements specified by other 
parameters. Default. 


The utility runs in' Simulation mode, performing analysis and 


reporting but not changing OI" deleting any files. 


Activating the Utility 


II EXEC CTDCLHXS [MODE=TESTIPROD] 


Return Codes 


0 


4 


8 


11 


12 
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Operation, perfo11med successfully 


Operation, perfo11med successfully (for HSM backup utility) 


Execution erro11 


Operation performed successfully (in, TEST mode) 


Invalid input parameters 
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CTDCP2A ·Copy Permanent User Report File to Active 


This utility copies job/user/report/category entries from the Permanent User Report List 
file to the Active User Report List file. This process is performed. once a day to create new 
empty entries (in WAIT DECOLLATlON status) for each job/user/report/catego11y/odate 
(original scheduling date). 


Any job/user/repo11t/category/odate entries which are already present on' the Active User 


Report List file are not copied (i.e., are not duplicated). 


INCLUDE/EXCLUDE Statements 


The scope 0£ the copy can be limited by one or more INCLUDE or EXCLUDE statements. 
Each INCLUDE/EXCLUDE statement contains parameters which limit the user/report list 
entries which will be copied. See "Record Selection Logic (INCLUDE/EXCLUDE 


Statements)" earlier in this section, for information, about p11efixing, masking, and the 


INCLUDE and EXCLUDE logic used to determine record selection .. 


Parameters in INCLUDE/EXCLUDE Statements 


The parameters which can be specified in INCLUDE/EXCLUDE statements are: 


JOB NAME 


USER 


REPNAME 


CATEGORY 


Job name 


User name 


Report name 


Category name 


Activating the Utility 
II EXEC C'.rDCP2A 


[INCLUDE {PARAMETERS}] 


[EXCLUDE {PARAMETERS}] 


The new repo11t entries are assigned the current CONTROL-D working date (not the 
computer date). It is possible to specify a specific date via parameter PARM=date (fovmat 
mmdd:yy, ddmmyy or yymmdd, depending on the site standard). 


The utility may be run simultaneously with the CONTROL-D monitor. 


Return Codes 


0 


8 


Operation performed successfully 


1/0 error, execution stopped 
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Example 


II EXEC CTDCP2A,PARM=date 


J:NCLUDE REPNAME=PROD-JCL 


CTDCP2A 


The following is the status of the files befolle the utility is rum 


Permanent User Repo:vt list file 


--USER-- 
-------REPORT------- 
---JOB•- 
----CATEGORY---- 


BRANCHOl 
DAJ:LY-BALANCE-REPORT 
D4DAJ:LYB 
DAJ:LY 


BRANCH02 
DAJ:LY-BALANCE-REPORT 
D4DAJ:LYB 
MONTHLY 


BRANCHOB 
DAJ:LY-BALANCE-REPORT 
D4DAJ:LYB 
DAJ:LY 


Active User Repo11t list file 


--USER-- 
-------REPORT------- 
---JOB-- 
----CATEGORY---- 
-ODATE- 


ACCTSRCV 
ACCOUN'l'S-RECEJ:V-REPT 
D4ACCRCV 
QUARTERLY 
070796 


ACCTSRCV 
ACCOUN'l'S-RECEJ:V-REPT 
D4ACCRCV 
WEEKLY 
070796 


BRANCHO! 
DAJ:LY-BALANCE-REPORT 
D4DAJ:LYB 
DAJ:LY 
070796 


BRANCH012 
DAJ:LY-BALANCE-REPORT 
D4DAJ:LYB 
MONTHLY 
070796 


The following is the status of the Active User R€pollt List file after the utility is run, on the 
5th of February: 


--USER-- 
-------REPORT------- 
---JOB-- 
----CATEGORY---- 
-ODATE- 


ACCTSRCV 
ACCOUN'l'S-RECEJ:V-REPT 
D4ACCRCV 
QUARTERLY 
070796 


ACCTSRCV 
ACCOUN'l'S•RECEJ:V-REPT 
D4ACCRCV 
WEEKLY 
070796 


BRANCHO! 
DAJ:LY-BALANCE-REPORT 
D4DAJ:LYB 
DAJ:LY 
070796 


BRANCH02 
DAJ:LY-BALANCE-REPORT 
D4DAJ:LYB 
MONTHLY 
070796 


BRANCH012 
DAJ:LY-BALANCE-REPORT 
D4DAJ:LYB 
MONTHLY 
0170796 


BRANCHOB 
DAJ:LY-BALANCE-REPORT 
D4DAJ:LYB 
DAJ:LY 
070796 
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CTDDELRP · Delete Reports Which Are Not Needed 


This utility cleans unneeded user/report/job entries from the Active User Report list file 
and erases from the disk compressed (CDAM) datasets which have no entries in the Active 


User Report List file. 


This utility also moves a report entry from the Active to the History User file or the 
Migrated User Repo11t List file when the DASD retention: period for that report has expired 
and the repo11t has been backed up or migrated successfully. 


The utility determines which reports are no longe11 needed (i.e., for backup, migration, 


Online viewing, or printing) by means of user-specified selection groups. A selection group , 
consists of; a DAYS statement and any number of; optional INCLUDE and/or EXCLUDE 


statements. The DAYS statement must contain a retention period which specifies the 
number of days the reports should remain, online, after which they should be deleted by 
the utility. The optional INCLUDE/EXCLUDE statements further qualify which reports 
belong to the selection, group. 


By specifying multiple selection, groups, each with its own' retention period, (and 


INCLUDE/EXCLUDE statements), groups of entries with differing retention periods can 
be deleted by a single execution of CTDDELRP. See "Record Selection' Logic 


(INCLUDE/EXCLUDE Statements)" in this section for information about p11efixing, 


masking, and the INCLUDE and EXCLUDE logic used to determine reco11d selection, 


Selection groups are scanned, sequentially. The processing of a repo11t is determined by the 
first selection group whose INCLUDE or EXCLUDE criteria match the report. 


INCLUDE/EXCLUDE criteria in other selection groups are ignored for that report. 


Utility CTDDELRP performs the following sequence of; steps: 


1. Records to be deleted mom the Active User file we selected, (acco11ding to the parameters 
specified for the utility) and written, to a temporary file. 


Records fo11 reports which, have been backed, up, are written to the Histoey file. 


CDAM files to be deleted we written to· an intermediate file. 


2: The temporary file is read and the records it contains we deleted from the Active User file. 


3. CDAM. files stored in the intermediate file (in:Step 1) we deleted. 


Parameters 


MODE 
This optional parameter in the EXEC statement determines whether 
utility CTDDELRP is run1 in Production mode or Simulation' mode .. If 
the pallameter is not specified, the default is Production mode. It is 
recommended that this utility be run in Simulation mode prior to 
being run in Production mode. 


PROD 


TEST 


The utility runs in Production mode, changing and 
deleting VSAM and CDAM files which satisfy the 
requirements specified by other parameters .. Default. 


The utility runs in Simulation, mode, performing analysis 
and reporting but not changing 011 deleting any files. 
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DAYS Statement 


The DAYS statement can contain the following parameters: 


n 


FORCE 


WAITPRINT 


WAITDEC/ 
NOTWD 


RESTORED/ 
NOTRST 


NO REPORT 


KEE PD SN 
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Retention, period (in days), a:t:ter which the repo11t expires and' is 
selected fo11 deletion from the Active Use11 Report List file by the 
selection group. 


By default, the report expires n days from the 011iginal scheduling date 
(ODATE) o:t:the report decollating mission. The IOA administrator can 
change the default so, that n, is calculated from the decollation date. 
Refer to optional wish WD1377 in' the IOA SEC'C:JDATA library. 


n can be a negative number (to, delete repo11ts created on future 
ODATEs) and cannot exceed 9999. 


This parameter is mandatory and must be the first parameter in the 
statement. 


When not specified, reports with WAIT BACKUP status are not 


deleted~ If specified, reports waiting backup are also deleted. 


If specified, reports with WAIT PRINT status are not deleted. If not 
specified, reports waiting to be printed are also deleted. 


WAITDEC deletes only reports having Wait Decollation status. NOTWD 


excludes from the selection group reports having Wait Decollation status. 
If neither pwameter is specified, Wait Decollation status does not affect 
report deletion. Both parameters cannot be specified in, the same 
selection group. 


RESTORED deletes only reports having Restored status .. NOTRST 
excludes from the selection' group reports having Restored status. If 
neither parameter is specified, Restored status does not affect repo:rt 
deletion. Both parameters cannot be specified in the same selection 
group. 


Note 
Parameters 
FORCE, 
WAITPRINT, 
WAITDEC, 
NOTWD, 


RESTORED and NOTRST apply· only· to the specific selection 
group in which they appear. They may be specified for as many 
selection groups as necessary; 


Deletes any SYSDATA entries and their CDAM datasets (original reports 
data) if the SYSDATA is not pointed to by any user entries (e;g., the user 
entries have been manually deleted), regardless of the retention value 
specified in1the DAYS parameter and all other selection, group parameters. 


Deletes reports from the Active User Report List file but does not 
delete CDAM datasets .. The CDAM datasets can then be re-decollated. 


Note 
Parameters NOREPORT and KEEPDSN apply to all selection 
groups regardless of the criteria specified for them. 
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NO INDEX 
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Prevents indexes from: being deleted fromi the DASE> (when, a repo11t is 


deleted), even, if the indexes ave defined· as non-resident. This 
parameter is valid only fo11 CONTROL-V. Indexes which are not 
deleted by utility CTDDELRP can be deleted, at a later stage using 
utility CTVDELI. 


INCLUDE/EXCLUDE Statements 


If multiple INCLUDE/EXCLl:JDE statements are specified, each statement can contain any 


011 all of the parameters listed below sepavated by a .space. However, each parameter can1 


appear no more than once in each statement. 


See "Record Selection Logic (INCLUDE/EXCLUDE Statements)" in this section for mo11e 


information: about INCLUDE and' EXCLUDE statements. 


General Parameters in INCLUDE/EXCLUDE Statements 


Each INCLUDE/EXCLUDE statement must contain, at least one of the following 
parameters: 


JOB NAME 


JO BID 


USER 


CLASS 


REPNAME 


CATEGORY 


Job name (or prefix). 


Job ID (format Jnnnnn). 


U se11 name (or prefix). 


Class .. 


Report name (or prefix). If the report name contains embedded spaces, 
replace each, embedded space with the @ character. 


Catego11y of repollt decollation mission. 


By default, the values specified for JOB NAME, USER and REPNAME are treated as 


pI1efixes .. To prevent a value from being considered a prefix, place the special character < 
after the value. 
· 


CDAM Dataset Parameters in INCLUDE/EXCLUDE Statements 


The following additional parameters can be specified fo11 CDAM datasets created directly 
viajob JCL SUBSYS parameters: 


PG MS TEP 


PROCSTEP 


DD NAME 


Program step name (which created 
1 the repoI1t). 


Procedure step name (which created, the report). 


DD name (which created 1 the repo11t). 


Notes 
PGMSTEP refers to the step name specified in a I I STEPOl 
EXEC PGM=pgmname statement. 


PROCSTEP refers to the step. name specified in a I I UPBOl 
EXEC procname statement which invokes a procedure. 
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CTDDELRP Deletion Rules 


CONTROL-DIV repo11ts ave identified by user entries, SYSDATA entries and CDAM 


compressed datasets. Each user entry may point to one 011 mo!le SYSDATA entries. Each 


SYSDATA entry points to· one CDAM dataset and is pointed to·. by one or more user entries. 
Each CDAM dataset is pointed to by one·or mo11e SYSDATAentries. 


When deleting repo!lts, CTDDELRP maintains the integrity of this data structure 
acco11ding to the following rules: 


• A CDAM compr:essed dataset is deleted when all' SYSDATA entries pointing to it ave 


deleted. 


• A SYSDATA entry is deleted when. all' user entries pointing to it are selected fo11 deletion, 


• A user entry is deleted when aU SYSDATA entries it points to are selected for deletion. 


• A user entry is also deleted when: aU SYSDATA entries to which it points do not exist (i.e., 
the SYSDATA entries were deleted, via the CONTROL-DIV Online facility). 


CTDDELR·P issues a message if it finds a SYSDATA entry which is not pointed to· by an:y 


user entry (i.e., the user entries were deleted, via the CONTROL-DIV Online facility) .. If 
parameter NOREPORT was specified, this SYSDATA entry is automatically deleted. 


Activating the Utility 


11 
EXEC CTDDELRP [, MODE=TEST I PROD] 


DAYS n [FORCE] [WAITPRINT] [WAITDEINOTWD] [RESTOREDINOTRST] [NOREPORT] 


[KEEPDSN] 


[INCIIUDE 
[JOBNAME=Jobname] [JOB:CD=jobid] ['O'SER=user] [CLASS=class] 


[REPNAME=repname] 


[DDNAME=ddname] 


[PGMSTEP=pgmstep] [PROCSTEP=procstep] 


[EXCLUDE 
[JOB NAME=Job name] [JOB:CD=jobid] [USER=user] [CLASS=class] 


[REPNAME=repname] 


[DDNAME=ddname] 


DAYS statement 


[INCIIUDE statement] 


[EXCIIUDE statement] 
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[PGMSTEP=pgmstep] [PROCSTEP=procstep] 
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Examples 


Example I 


//S1 EXEC C'l'DDELRP 


DAYS 3 


The utility deletes reports which are older than three days if they have been backed up 
and have either WAIT PRINT or PRINTEIJ> status .. 


Example 2 


//S1 EXEC C'l'DDELRP 


DAYS 0 WAITPRIN'l' 


A disk space saver. All reports that were backed up and printed are deleted; Reports 
waiting for migration~ print and/or backup are not deleted. 


Example 3 


//S1 EXEC C'l'DDELRP 


DAYS 5 


INCLUDE REPNAME=PROD-JCL 


All reports with name p11efix PROD-JCL which are more than five days old are deleted 
unless they have not yet been1 backed up: 


Example 4 


//S1 EXEC CTDDELRP 


DAYS 0, FORCE 


INCLUDE JOB NAME=Y99BUP0l JOBID=J0l923 


All: reports of the specified job name and 1 Job ID are deleted~ regardless of WAIT 
BACKUP/WAIT PRINT status. 


Example5 


Assume the following repo11t names exist: ACCT, ACCT-REC, ACCT-PAY. 


//S1 EXEC CTDDELRP 


DAYS 0· 


INCLUDE REPNAME=ACCT* 


All of the above reports are deleted. 


//S1 EXEC CTDDELRP 


DAYS 0 


INCLUDE REPNAME=ACCT< 


Only report ACCT.is deleted. 


Example 6 


//S1 EXEC C'l'DDELRP 


DAYS O•WAITPRIN'l' 


EXCLUDE REPNAME=PROD-JCL 


EXCLUDE.CLASS=X 


EXCLUDE JOB NAME=POO* 
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All reports which have already been1 migrated, printed and backed up (if backup was 
requested) are deleted from DASD, except: 


• 
The p11oduction JCL reports. 


• 
All reports produced on output Class X. 


• 
All reports piioduced by jobs with names beginning POO. 


Example 7 


//S1 EXEC CTDDELRP 


DAYS 7 WAITPRINT 


INCLUDE JOB NAME=PROD* 


DAYS 3 FORCE 


INCLUDE JOB NAME=TEST* 


All repo11ts older than seven days and created by jobs with names beginning PROD a11e 


deleted except reports waiting for print .. 


All reports older than three days and created by jobs with names beginning TEST are 
deleted, regardless of WAIT BACKUP/WAIT PRINT status. 


Example 8 


//S1 EXEC CTDDELRP 


DAYS 3 WAITPRINT RESTORED 


DAYS 1 WAITDEC 


DAYS 101 WAITPRINT NOT RST NOT WD 


DAYS 0 


INCLUDE USER=SCRAP 


All repoI1ts that were restored at least three days ago· are deleted except reports still 


waiting for print. 


All report entries with a status of WAIT DECOLLATION (created via utility CTD<I:P2A) 


that al'le older than 
1 one day are deleted .. 


All reports older than, ten days with neither RESTORE no11 WAIT DECOLLATION status 
and which already printed are· deleted. 


All report entries belonging to. user name SCRAP are deleted. 


Example 9 


//S1 EXEC CTDDELRP 


DAYS 4 NOREPORT 


All reports which ave older than four days will be deleted 
1 
• 


All reports which have only a SYSDATA reco11d (no user reco11d points to them~ will be 
deleted, even the SYSDATA record is one day old, 


Note 
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This utility is fully recoverable. If an abend occurs at any step· of the utility, fix the 
problem and rerun the utility from the first step. 
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CTDDIB - Rebuild Index Component of a User Report List 
File 


Utility CTDDIB is used to rebuild a CONTROL-D User Report List file's index component. 
The new index component co11responds to info11mation currently contained in the IOA 


Access Method file's data component. Previous contents of the index component are erased. 


Note 
The index component that is to be rebuilt must be allocated and formatted prior to 
activating the utility; 


This utility should be used when an integrity p11oblem is detected, in an TOA Access Method 
file's index component. In, this case: 


• Delete and reallocate the index component. 


• Format the index component with, utility IOADBF. 


• Rebuild the index component with utility CTDIDIB. 


Activating the Utility 


//BUICLD 
EXEC 
CTDD:J:B 


Parameters 


The following parameter can be specified' to the utility ini the EXEC statement which 
invokes the CTDDIB JCl1 p11ocedure. 


DBFlLE 


Example 


//BUlCLD 
EXEC 


CONTROL-D IOA Access Method file's dataset name suffix. 


ACT 
Active User Report List file. 


PRM 
Permanent User Report List file. 


HST 
Histo:cy User Repoiit List file. 


MIG 
Migrated User Report List file (CONTROL-V only) 


CTDDlCB,DBFlCLE=HST 


Refer to sample job CTDUFDlB in the CONTROL-D JCL lib11a11y fo11 an, example ofi how to 
rebuild a IOA Access Method file index component. 
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CTDUPBKP - Update Backup Details 


This utility is p:riimarily used to update retention period and backup volume serial 
numbers in History/Migration/Active User Report files. 


This utility can also be used to switch PRIMARY and: SECONDARY infovmation in the 
Migration User Report List file. 


The utility receives the following groups of parameters: 


• Selection, parameters 


• CHANGETO parameters 


• Report paxiameters 


The utility scans the file(s) that are specified via the Selection parameters and modifies 
the specified recovds in those files according to the CHANGETO parameters. Report 
parameters specify characteristics of the report to be p11oduced. 


Activating the Utility 


//UPDATE 
EXEC C'l'DUPBKP 


//DAUl:N 
DD* 


SELECT 


[FI:LE=ACT] 


[FI:LE=HST] 


[FI:LE=MI:G] 


[DECFROM=ddmmyy,bbmm] 


[DECTO=ddmmyy, bbmm] · 


[BKPFROM=ddmmyy,bbmm] 


[BKPTO=ddmmyy,bbmm] 


[BKPMI:S=backup/migration mission name] 


[PLATTER=platter name] 


[VOLSER=old volser] 


[SI:MULATE=YES/NO] 


CHANGE.TO 


I* 


[GENER=number of generation/NONE] 


[RETPD=retention period] 


[VOLSER=new volser] 


[SECONDARY] 


[PR:CMARY] 


//DAULST 
DD * 


[PR:CNTSYS] 


/* 
II 


[DETAI:L] 


[UNMATCH=ALL/VOLSER] 
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Selection Parameters 


The following parameters can be specified in the SELECT statement: 


FILE 


DECFROM 


DECTO 


BKPFROM 


BKPTO 


BKPMIS 


VOLSER 


Type o£file to be acted 1upon, Specify at least one of the following tluiee files: 


ACT 


HST 


MIG 


Active User file 


Histocy User file 


Migration1 User file 


This parameter is mandatory. 


Earliest decollation 
1 date and time 0£ reports to be selected for update. 
Format: date, time. Both parameters are optional, but time cannot be 
specified without specifying date. 


Date format is mmddyy, ddmmyy or yymmdd (depending on the site 
standard defined in installa.tion 1 member IOAP ARM). 


Time format is hhmmss. 


Latest decolla.tion date and time of reports to be selected for update. 
Format: date, time. Both parameters are optional, but time cannot be 
specified without specifying date. 


Date format is mmddyy, ddmmyy or yymmdd1 (depending on the site 


standal'd defined inr installation' member I OAP ARM.). 


Time format is hhmmss. 


Eadiest backup date and time of repol'ts to be selected for update. 
Format: date, time .. Both parameters are optional, but time cannot be 


specified, without specifying date. 


Date format is mmddyy, ddmmyy or yymmdd (depending on the site 
standard defined' in installation member I OAP ARM). 


Time format is hhmmss. 


Latest backup date and time of repol'ts to be selected for update. 
Format: date, time. Both parameters are optional, but time cannot be 
specified without specifying date. 


Date format is mmddyy, ddmmyy or yymmdd (depending on the site 
standard defined in installation member I OAP ARM.). 


Time fo11mat is hhmmss. 


Backup mission name. Validity checks are identical to DO BACKUP in 
the de collation .. Optional. 


Volume serial number to be updated. A maximum 0£ 10 volume serial 
numbers can be specified. Optional. Up to 6 characters can be 
specified. Example: 444444, 555555, 666666. 
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PLATTER 


SIMULATE 


CTDUPBKP 


Platter name .. A maximum of 9 characters .. This parameter is used as 
a selection: parameter for migration: files, and can be specified fov 


Kodak OptiStar Storage System (OSS) only. 


YES 


NO 


Files are not updated; Only a report 0£ aU reco11ds to be 
updated is produced. Default. 


Files are actually updated. 


CHANGETO Parameters 


The following pa11ameters can be specified in the CHANGETO statement: 


GENER 


RETPD 


VOLSER 


PRIMARY 
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Number of generations. Valid values are: 


nnnn· 


NONE 


Valid numeric value greater than1zero. 


Only parameters FILE=HST and BKPMIS=BKPNAME 
can be defined.inthe SELECT group; 


Parameter RETPD 
must not be 
defined in the 


CHANGETO 
group. 
Reports 
belonging 
to 
the 
corresponding Backup mission, are switched from "DAYS 
TO KEEP" method to the "GENERATIONS TO KEEP" 
method. The value of "DAYS TO KEEP" is automatically 
set to 0000; If there is no corresponding Backup control 
record in, the History file, this utility creates it. 


Parameter RETPD must be defined· in the CHANGETO 
group; 


Reports belonging to the corresponding Backup mission 


are switched from "GENERATIONS TO KEEP" method to. 
the "DAYS TO KEEP" method. 


Four-digit value identical, to the "DAYS TO KEEP" value in the 
Backup mission. 


If this parameter is specified without specifying parameter GENER, 
the "GENERATIONS TO KEEP" should be 0 in the co11responding 
Backup control record in 
1 the Histo11y file. Otherwise, utility 


CTDBPBKP produces an errov message. 


A new volume serial number for the volume be updated. Each volser 
specified can1 be up to 6 characters in length, A maximum of 10 volsers 
can be specified (e.g~, 111111, 222222, 333333). The number of: volsers 
specified must be identical to the number of volsers selected (via the 


CHANGETO parameters described above). 


If utility CTDBPBKP was run with parameter SECONDARY 


specified, running this utility again with pavameter PRIMARY causes 
the primary migrated copy of CDAM and index files to be used when 
accessing the migrated repovt. FlLE=MIG must be specified in the 


SELECT group; 
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If utility CTDUPBKP was run with pa11ameter SECONDARY 
specified, the secondary migrated copy of CDAM and index files will 


be used when1 accessing the migrated report. FILE=MIG must be 
specified in the SELECT group. If there is no secondary migration 


info11mation, info11mation1 in1 SYSDATA 011 the index record, this 
parameter is ignored. 


Note 
Parameters PRIMARY and SECONDARY are relevant if the 


SECONDARY parameter was specified in the migration mission 
definition screen. 


Report Parameters 


DETAIL 
Print a detailed report for all volsers found in the file(s), including the 
backup job name, date and time. This repo11t is useful only when a 
new volser was requested. 


UNMATCH 
Produce a report listing all volsers in the file(s) that did not match 
any of the old volsers defined in the DAUIN DD input file. 


ALL 


VO:LSER 


In any case. 


Prints a report only ifvolser update was requested. 


PRINT SYS 
Produce a repo11t detailing all sysdata records. 


Example! 


//UPDATE 
EXEC CTDUPBKP 


//DAU!l:N 
DD * 


SELECT 


I* 


F:CLE=HST 


DECFROM=250696 1 1000 


DECT0=270696,1500 


BKPFROM=260696,1000 


BKPT0=280696,1500 


BKPM:IS=BKPOO! 


S:CMULATE=YES 


CHANGE TO 


//DAULST 
DD * 


II 


The utility creates a repollt for the History file. Every SYSDATA which was created on 
25/06/96 at 10 o'clock until 27/06/96 at 3 o~clock and was backed up on 26/06/96 at 10 o'clock 
until 28/06/96 at 3 o'clock by the backup mission BKPOOl will be printed in this report. 
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Example2 


//'f1DPA~ 
EXEC CTDOPBKP 


//DAOIN 
DD 1 * 


SELECT 


F:CLE=ACT · 


F:CLE=HST 


BKPFROM=260696,1000 


BKPT0=280696,1500 1 


BKPMIS=BKP001 


VOLSER=VOL001 


SIMOLA~=NO 


CHANGE TO 


RE'l'PD=0100 


VOLSER=VOL002 


//DAtmST 
DD * 


PRINTSYS 


DETA:CL 


CTDUPBKP 


If a CDAM was backed, up to volser VOLOOl on' 26/06/96 from 10 o~clock until 28/06/96. at 
3 o'clock by backup mission BKPOOl, the corresponding SYSDATA from the Active User 
file and History User file will be changed. The new value 0£ RETPD is 100 and the new 
value ofVOLSER is VOL002. A report about every SYDATA from the Active User file and 
the History User file and, a report about every changed SYSDATA (detail) will be produced. 


Example3 


//UPDATE 
EXEC CTDOPBKP 


//DAOIN 
DD * 


SELECT 


F:CLE=MIG 


BKPMIS=MIGOO!I. 


PLATTER=PLATTERO!I. 


SJ:MtmATE=YES 


CHANGE TO 


SECONDARY 


//DAtmST 
DD* 


In this example,. a simulation is performed for switching SYSDATA and INDEX reco11ds of 
the Migrated User file to use the secondary migrated CDAM files. Only the SYSDATA and 
INDEX records for CDAM files which were migrated to platter PLATTEROl by migration 
mission MIGOOl will be selected. The result of this simulation is a report of the selected 


SYSDATA records. No change is made to the records themselves. 
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Example 4 


//UPDATE 
EXEC CTDUPBKP 


//DAU:CN 
DD * 


SELECT 


F:CLE=HST 


BKPM:CS=BKPOOl 


S:CMUIIATE=NO 


CHANGE TO 


GENER=0005 


//DAtmST 
DD * 


Section 9: Utilities 


SYSDATA reco11ds referring to backup m1ss1on: BKPOOI are set to use the "# of 


GENERAITONS TO KEEF" method (In: this example, 5 generations should be used.) A 
report for the modified SYSDATA recoi:ids is pi:ioduced. 


See sample job CTDBBKPJ in the CONTROL-D JCL library fo11 an example of how to 
update backup information in CONTROL-D User Report List files. 
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CTVCLMIG - Clean Migrated CDAM Files 


This CONTROL-V utility cleans entries from the Migrated User Report List file and erases 
and/or uncatalogs the CDAM datasets and index files that belong to these entries. 


The Migrated User Report list file contains entries describing migrated user repor:ts and 
indexes. Each report has a retention period. The utility scans the Migrated User Report 
List file for all the reports whose retention period has passed and deletes them from the 
Migrated User Report List file. 


For: non~DASD reports, the utility pvoduces a list 0£ cartridges which can, be returned to 
the global tape pool. 


For: FileTek migrated repor:ts, a temporary file with report names and their MEDIA type is 


created. This file is p11ocessed by the next step which deletes them from the FileTek SM. 


Activating the Utility 


11 EXEC CTVCLMJ:G [I MODE=TEST I PROD]. 


Return Codes 


0 


4 


8 


11 


12 
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Operation performed successfully 


Operation performed successfully (fo11 HSM backup utility) 


Execution error 


Operation perfor:med successfully (in TEST mode) 


Invalid input parametevs 
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CTVDELI - Delete Index Files from DASD 


This CONTROL-V utility scans the Migrated, User Report list file and erases from the disk 
index files which are no longer needed on DASD. The utility determines which indexes to 
delete based on: user-specified selection groups. 


Note 
Indexes that have been deleted from DASD by utility· CTVDELI will be retrieved from 
the migrated media when required. 


A selection group consists of a DAYS statement and any number of optional INCLUDE 


and/or EXCLUDE statements. The DAYS statement must contain a retention period which 
specifies the number 0£ days the indexes should remain on DASD, after which they are 


deleted by the utility. The optional INCLUDE/EXCLUDE statements further qualify which 
indexes belong to the selection group; 


By specifying multiple selection' groups, each with its own' retention period, (and 


INCLUDE/EXCLUDE statements), groups of entries with differing retention periods can 
be deleted by a single execution 0£ utility CTVDELI. See "Record Selection Logic 


(INCLUDE/EXCLUDE Statements)" in' this section for information about prefixing, 
masking, andthe INCLUDE and EXCLUDE logic usedtodetermine record 
1 selection. 


Selection groups are scanned sequentially. The processing of a report is determined by the 
first selection group whose INCLUDE or EXCLUDE criteria match the index. 


INCLUDE/EXCLUDE criteria in, other selection groups are igno!'ed fol' that index. 


$INDEX records are not deleted from the Migrated User Report list file because they are 
needed for accessing the migrated index file. 


After an' index file is deleted> a flag indicating INDEX DELETED FROM DASD is placed 
1 
in the corresponding $INDEX record. 


EXEC Statement 


The EXEC statement can contain, the following parameter:· 


MODE 
This optional parameter on, the EXEC Statement determines whether 
utility CTVDELI is run in Production Mode or Simulation, Mode. If the 
parameter is not specified, the default is Production, Mode. It is 
recommended that this utility be run in Simulation Mode prior to 
being run: in Production Mode. 


PROD 


TEST 


The utility runs in Production' Mode, deleting index files 
which satisfy the requirements specified by other 
parameters. Default. 


The utility runs in' Siinulation Mode, performing analysis 
and reporting but not deleting any indexes. 
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DAYS Statement 


Parameters in the DAYS Statement 


The DAYS statement can contain the following parameters: 


RESIDENT 


Retention period (in days) after which1 the index expires and is 
selected for deletion from the Active User Report List file by the 
selection1 group. 


By default, the index expires n days from the Original Scheduling 
Date (ODATE) of the Report decollating 
mission~ The IOA 


administrator can1 change the default so· that n is calculated from the 


decolla.tion date. 


n can be a negative number (to delete reports created on future 
ODATEs) and' cannot exceed 9999. 


This parameter is mandatory and1 must be the first parameter in the 
statement. 


If RESIDENT is specified, resident indexes are deleted. Otherwise, 
resident indexes are not deleted. 


Parameter RESIDENT only applies to the specific selection· group in, 
which it appears. It may be specified for as many selection groups as 
necessary. 


INCLUDE/EXCLUDE Statements 


If multiple INCLUDE/EXCLUDE statements are specified, each statement can contain any 
or all of the parameters listed· below separated by a space. However, each pavameter can1 


appear no· more than once in, each 1 statement. 


See "Record Selection Logic (INCLUDE/EXCLUDE Statements)" above for more 
information about INCLUDE and EXCLUDE statements. 


Parameters in INCLUDE/EXCLUDE Statements 


Each INCLUDE/EXCLUDE statement must contain' at least one 0£ the following 
parameters: 


JOB NAME 


JO BID 


REPNAME 


IXNAME 


Job,name or prefix. 


Job ID (format Jnnnnn). 


Report name or prefix. 


If the report name contains embedded spaces, replace each embedded 
space with the@chavacter. 


Index name or prefix. 


By default, the values specified for JOB NAME, REPNAME and IXNAME are treated as 


pvefixes. To pvevent a value from being considered a pvefix, place the special character < 
after the value. 
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Activating the Utility 


II 
EXEC 
CTVDELI[,MODE=TESTIPROD] 


DAYS 
n 
[RESIDENT] 


[INCLUDE 


[EXCLUDE 


[JOB NAME=Jobname] [JOBID=jobid] [IXNAME=indexname] 


[REPNAME=repname] 


[JOB NAME=Jobname] [JOBID=jobid] [IXNAME=indexname] 


[REPNAME=repname] 


DAYS statement 


[INCLUDE statement] 


[EXCLUDE statement] 


Example 1 


llS1 
EXEC 
CTVDELI 


DAYS 3 


All non~resident indexes which are older than three days ave deleted. 


Example 2 


llS1 
EXEC 
CTVDELI 


DAYS 01 


A disk space saver. All non-resident indexes are deleted~. 


Example 3 


llS1 
EXEC 
CTVDELI 


DAYS 5 


:CNCLUDE 
REPNAME=PROD-JCL 


All indexes of reports with name prefix PR·OD-JCL which are more than five days old are 
deleted. 


Example 4 


llS1 
EXEC 
CTVDELI 


DAYS 0 
1 
RESIDENT 


INCLUDE 
JOBNAME=Y99BUP01 
JOBID=01923 


All indexes (including resident indexes) with the specified job name and Job ID are 
deleted. 
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Example 5 


Assume the following index names exist: ACCT, ACCT-REC, ACCT-PAY. 
//Sl 
EXEC 
CTVDELI 


DAYS 0' 


INCLUDE 
IXNAME=ACCT 


All of the above indexes a:ve deleted. 


//Sl EXEC 
CTVDELI 


DAYS 0 


INCLUDE 
IXNAME=ACCT< 


Only index ACCT is deleted. 


Example 6 


//Sl EXEC 
CTVDELI 


DAYS 0 


EXCLUDE IXNAME=PROD-NDX 
JOB NAME=POl 


All non-resident indexes are deleted from DASD except: 


• Indexes whose name begins withPROD-NDX. 


• Indexes for reports produced by jobs whose name begins with POl. 


CTVDELI 
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CONTROL-0 Utilities 


CTOCSF - Copying the Message Statistics File 


Utility CTOCSF copies the Message Statistics file. The utility is generally used to create a 
new Message Statistics file whose size will be better adapted to the installation's needs. 


Before copying the file, the following steps must be followedc 


1. If the CONTROL-0 monito11 is active, stop the CONTROL-0 statistics collection task 
using the command: 


F CONTROLO,STOPSTATS 


Message CT0189I indicates that statistics accumulation has stopped. 


2; Verify that no users have allocated the Message Statistics file using CONTROI:r-0 screen OM. 


3. Rename the current Message Statistics file (input file for the copy operation), for 
example, via ISPF 3.2/3:4. 


4. Pe11fo11m the following steps in ICE: 


• Verify that CTO is specified as the Product ID. 


• Select the CUSTOMIZE activity from the menu .. 


• Select Majov step "CTOPARM Post-Installatiom" 


• Select Minor step ''Update CTOPARM Variables." 


• Change parameter STREC# from 10000 records to 20000 records to change the size 
of the new Message Statistics file. 


• Select Minor step."Save Parameters Into.Product Libral'ies.~ 


• Select Minor step· "Compile and Link CTOP ARM." 


5. Allocate and format the new Message Statistics file (output file for the copy operation) 
using member DEFSTAT in the IOA INSTCTO library. 


6~ Edit member CTOCSFJ,in the CONTROL-0 JCL library. Change DD statement DASTF 
DSN to match the name specified in Step 3: 


Example 


//COPYST JOB 


//COPYF~LE EXEC CTOCSF 
//DASTF DD D~SP=SHR1DSN=old-dsname 
II 


Where: 


old~dsname is the name specified in' Step 3 above .. 


After the Message Statistics file has been copied; the statistics collection task may be 
restarted using the following command: 


F CONTROLO,STARTSTATS 


Message CT0184I indicates that statistics accumulation has started. 
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CTORSTM- Statistics Report Utility 


Utility CTORSTM generates statistical reports based on infol'mation' provided by the 
Message Statistics Facility. CTORSTM output can' be used to analyze site automation 
requirements and the progress of; the automation process. CTORSTM output can also be 
used as input for report generator utilities (e.g., SAS, SP/SS, or EASYTRIEVE). 


A sample JCL which invokes procedure CTORSTM can be found in member CTORSTMJ in 
the CONTROL-0 JCL library. The output report is written to SYSPRINT. 


Report parametel's are passed to utility CTORSTM via DD statement DAREPIN. 


SORT Parameter 


The foUowing parameter can be specified to. sort the report data. 


SORTBY [MSGID J 
COUNT 


Indicates whether the report should be sorted according to 
message ID (MSGID) or message count (COlJNT), with the most 
frequent messages appearing first. Default: SORTBY COUNT. 


INCLUDE/EXCLUDE Statements 


The scope of the copy can be limited by one or more INCLUDE or EXCLUDE statements. 
Each INCLUDE/EXCLUDE statement contains parameters which limit the messages for 


which statistics are collected. See "Record Selection Logic (INCLUDE/EXCLUDE 


Statements)" earlier in this section for information, about prefixing, masking, and the 


INCLUDE and EXCLUDE logic used to determine reco11d selection, 


Parameters in INCLUDE/EXCLUDE Statements 


The parameters which can be specified in INCLUDE/EXCLUDE statements are: 


msg 


Example 


//REPORT EXEC CTORS'l'M 


//DAREPIN DD * 


INCLUDE DFH* 


INCLUDE $HASP* 


EXCLUDE $HASP100' 


SORT BY MSGID · 


I* 
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Message ID (e.g., DFHl 799) or mask (e.g., DFH*). Defaults: 


INCLUDE* 


EXCLUDE blank 


Include all messages. 


Do not exclude an:v messages. 
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CTOALOCP - Backing Up the Automation Log 


Utility CTOAL00P copies the contents of one Automation Log file to another Automation 
Log file 011 to a sequential dataset. The utility may be used to perfovm anl}' of the following 
functions, depending on the parameters submitted: 


• Backing up the Automation Log to another Automation Log; Such Automation Log backup 
files can be displayed) just like the current Automation Log file, via the Automation Log 
screen' (option OL). 


• Increasing the size of the cu.r:rent Automation1Logfile. 


• Copying the Automation, Log to a sequential file. Such a sequential file can be processed by a 


repoiit generator utility or restoved and displayed later as an Automation Log file. 


• Restoring a sequential, backup file to the format of an1Automation Log file. 


• Changing the dataset organization of an Automation Log; 


The parameters are passed to utility CTOALOCP via DD statement DAALPPRM. 


The following pavameters can be specified: 


STARTDATE 


STARTTIME 


END DATE 


ENDTIME 


FRO MD SN 


FROMTYPE 


TOD SN 


TO TYPE 


TOVOLUME 


Eadie st date of the log records to· be copied. Format: yymmdd. 
Default: Date of the earliest recovd in the log. 


Earliest time of the log recovds to be copied. Fovmat: hhmmss. 
Default: 000000. 


Latest date of the log records to be copied .. Format: yymmdd .. Default: 
Date of the latest record in the log. 


Latest time of the log records to be copied; Format: hhmmss. Default: 


240000~ 


Name of the input dataset for the copy operation. Default: Name of 
the Operational Automation Log file. 


Organization of the input dataset. Valid values are S and blank. Type 


S must be specified if the input dataset is a sequential file. For all 
other input dataset types, the field must be blank. 


Name of the output dataset for the copy operation, 


Organization of the output dataset. Valid values are: 
v 


D 
s 


DW (VSAM Linear) dataset. 


Direct Access (BDAM) dataset. 


Sequential file. 


The default is the type of the Operational Automation Log (i.e., the 
value of parameter AUTOMLOG in member CTOPARM). Refer to the 


IOA Installation Guide. 


Name (volser) of the volume on which the dataset named in the 
parameter TODSN will reside. This pavameter is mandatory for an 
output dataset of type V (as specified explicitly with parameter 


TODSN ov by default). 
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TO UNIT 
Name of: the unit to which the output dataset win be allocated. 
Default:. SYS.ALLDA. 


TORECNUM 
Number of records allocated to the output file. (This value is used to 
determine the size of: the output dataset.) 


Valid values are: 


nnnnnnnn· 


MINIMAL 


Specified number of records. 


The output file is allocated the exact number of: records, 
copied from the input dataset, based on date and time 
specified limits. 
If no value was specified, the default is the number of: records in the 
input file. 


Automation Log Backup Utility - Examples 


1. Copy the entire Operational Automation Log to another file of same size: 


TODSN 
SYS3.MYLOG 
TOVOLUME 
WORX02 
TOUNJ: 
D:CSK 


2; Copy the entire Operational Automation: Log to 1 a larger file: 


TODSN 
SYS3.MYLOG 
TOVOLUME 
WORX02 


TO UNIT 
DJ:SK 
TORECNUM 
100000: 


3~ Restore a sequential file to the format 0£ a direct access (BDAM.) Automation Log file: 


FROMTYPE 
S 
TOD SN 
SYS3.MYLOG.DTYPE 
TO'l'YPE 
D1 


TOVOLUME 
WORX02 
TO UNIT 
DISK 


4. Back up part of the Operational Automation Log to, a file oni the basis of date/time 
limits. (The output file will contain only the records selected~) With CONTROL-M, the 
date/time may be set using the CONTROL-M AutoEdit facility. 


STARTDATE 951027 
STARTTIME 150000 
ENDDATE 
951027 
ENDTIME 
200000 
'l'ODSN 
SYS3.MYLOG.D2710.F15T20 


TOVOLUME 
WORX02 
TOUNIT 
D:CSK 
'l'ORECNtJM 
MINIMAL 


5; Copy part of the Operational Automation Log file to a sequential file: 


S'l'AR'l'DA'l'E 951020 
ENDDATE 
951021 
TODSN 
'l'O'l'YPE 
'l'OVOLUME 


TO UNIT 


SYS6.MYLOG.F20'1'21 


s 


WORX02 
DISK 
'l'ORECNtJM 
MINIMAL 
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CONTROL-T Utilities 


Record Selection Logic (INCLUDE/EXCLUDE Statements) 


General 


Certain CONTROL-T utilities accept selection' criteria that determine which records 


should 
1 be processed, when the utility runs. These selection criteria are specified as 
expressions in INCLUDE and EXCLUDE statements which are supplied as pal'ameters to 
the utility. 


INCLUDE and' EXCLUDE statements al'e grouped into blocks .. An INCLUDE/ EXCLUDE 


block consists of no more than one INCLUDE statement followed by any number 0£ 


corresponding EXCLUDE statements. 


INCLUDE and EXCLUDE expressions, statements and blocks are described on the 
following pages. 


Expressions 


Expressions are used to specify selection criteria. The format 0£ an expression is: 


key operator value 


where: 


key 


operator 


value 


A parameter (field) in the record. Each key listed in each 


INCLUDE/EXCLUDE statement must be unique. 


Relational symbols used to compare key to value (e.g.,=,-, or!, <, >). 


Number or character string (which may include mask characters) 
against which to· compare key. 


Note 
See "Logical Field Names for the CONTROL-T Repository" in 
Appendix D of this guide for valid values that can be specified 
in INCLUDE/EXCLUDE statements in CONTROL-T. 


Only the = or -, operators may be specified when key and value are 0£ character type. 


Mask characters can, be specified in expressions whose operator is either = or -. For 
additional information on masking, see "Character Masking" in Section 2 of the 
appropriate user manual. 


INCLUDE Statements 


INCLUDE statements determine which records should be processed by the utility 
according to selection criteria• 
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INCLUDE statements are composed of expressions (at least one) separated by commas. 


The format of an INCLUDE statement is:. 


:CNCLUDE Expressionl, Expression2, ••• , ExpressionN 


All the expressions in an INCLUDE statement must be true for the statement to be true 
(i.e., the relationship between· the expressions within one INCLUDE statement is AND). 


EXCLUDE Statements 


EXCLUDE statements determine whiah 1 records should not be processed by the utility 
according to· selection criteria. 


EXCLUDE statements are composed of expressions (at least one) separated by commas. 


The format of an EXCLlJDE statement is: 


EXCLUDE Expression:!., Expression2, ••• , ExpressionN 


All the expressions in: an EXCLUDE statement must be true for the EXCLUDE statement 
to be true (i.e., the relationship between the expressions within one EXCLUDE statement 
is AND). 


INCLUDE/EXCLUDE Block 


An INCLUDE/EXCLUDE block is composed ofi no more than one INCLUDE statement 
followed by any number of its corresponding EXCLUDE statements. 


The format ofi an INCLUDE/EXCLUDE block is: 


Include Statement 


AND 


Exclude Statement 


OR 


Exclude Statement 


OR 


OR 


Exclude Statement 


The relationship between multiple EXCLUDE statements in a block is OR. 


The relationship between an, INCLUDE statement and the following EXCLUDE 


statement(s) in a block is AND. 


Single INCLUDE/EXCLUDE Block Processing 


If even one EXCLUDE statement of a block is true (i.e., a record satisfies the EXCLUDE 


statement), the record is not selected, and the next record is examined. 
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If all EXCLUDE statements in the block are false, the INCLUDE statement is evaluated. 


• If the INCLUDE statement is true, the reco11d is selected, 


• If the INCLUDE statement is false, the record is not selected and the next reco11d is examined~ 


Multiple INCLUDE/EXCLUDE Blocks 


An unlimited number of INCLUDE/EXCLUDE blocks may be specified. If multiple 


INCLUDE/EXCLUDE 
blocks 
are 
specified, 
the 
relationship 
between 
the 


INCLUDE/EXCLUDE blocks is OR and blocks are checked sequentially. If a record is not 
selected based, on' an INCLUDE/EXCLUDE block, it is checked against the next 


INCLUDE/EXCLUDE block. Once a reco11d is selected based on an INCLUDE/EXCLUDE 


block, the record is included and not checked against other blocks. 


Include Statament 


AND 


INCLUDE/EXCLUDE BLOCK #1 
I Exclude Statament I 
OR 
I Exclude Stalllment I 
OR 
I Exclude Stalllment I 


OR 


Include Statament 


AND 


INCLUDE/EXCLUDE BLOCK #2 
I Exclude Statament I 
OR 
I Exclude Stalllment I 
OR 
I 
Exclude Statament I 


OR 


Include Statement 


AND 


INCLUDE/EXCLUDE BLOCK #3 
I Exclude Statement I 
OR 
I Exclude Statement I 
OR 
I Exclude Stalllment I 


INCLUDE/EXCLUDE Examples 


The following examples illustrate include/exclude logic: For all but the last example, 
assume the following expllessions, all of which evaluate to True. 


Expression 1: 


Expression1 2:. 


Keyl=Valuel True 


Key2=Value2 True 
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Expression 3: 
Key3=VaJ.ue3 True 


Example 1 


Select all records which match these expressions: 


INCLUDE Keyl=Value1,Key2=Value2,Key3=Value3 


Example 2 


Select all records which match these expressions, using another method: 


INCLUDE Keyl=Valuel 


EXCLUDE Key2--,Value2 


EXCLUDE Key3--,Value3 


Example 3 


Select all records which, match the first expression, and either the second or third 
expressions: 


INCLUDE Keyl=Valuel 


EXCLUDE Key2...,Value21Key3-.Value3 


Example 4 


Select all records which do not match these expressions: 


INCLUDE Keyl--,Valuel 


INCLUDE Key2--,Value2 


INCLUDE Key3--,Value3 


Example 5 


Select an records which match either the second or third expvession, but do· not match the 
first expression: 


INCLUDE Key2=Value2 


EXCLUDE Keyl=Valuel 


INCLUDE Key3=Value3 


EXCLUDE Keyl=Valuel 


Example 6 


The following example utilizes actual values (instead ofthe terms KeyN and ValueN). 


Select the recovds of all volumes starting with FD whose dataset name starts with 


BACKUP, except fov those volumes starting with FD but ending with 102. Furthermore, 
independent of the preceding selection criteria, select recovds created by jobs whose job 
names stavt with CTT. 


INCLUDE VOLSER=FD*,DSNAME=BACKUP* 


EXCLUDE VOLSER=FD?102 


INCLUDE CREJBN=CTT* 
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CTTACP - Copy Trace File 


This utility can be used1 to: 


• Copy a Trace file to another pre-formatted Trace file. 


• Copy a Trace file to· a sequential1 vari.able-blocked file, enablmg the output to be formatted to 
a Hexadecimal or Dump display format. 


• Copy a sequential, variable-blocked file containing Trace data back to a formatted Trace dataset. 
If this Trace dataset contains data, the sequential1file's contents will be appended to it. 


Note 
The Trace file that is to be created must be formatted prior to activating the utility. 


Activating the Utility 


II 
EXEC 


llSYS'X.N 


CTTACP 


DD 
* 


COPY 
FROM=TRACEISEQ,TO=TRACEISEQ 


<INCLUDE/EXCLUDE STATEMENTS> 


OU'l'PU'l' 
TYPE=TIXIDICIF,L'X.NES'X.ZE=size 
II 


Parameters 


The following parameters can be specified to the utility in 
1 the EXEC statement which 
invokes the CTTACP JCL p11ocedure: 


TRCIN 


TRCOBT 


Name of source file. 


Name of target file. 


Parameters are also supplied via DD statement SYSIN: 


COPY 


INCLUDE/ 
EXCLUDE 


Copy statement type. 


FROM 


TO 


Source dataset type: 


TRACE 


SEQ 


Source is a CONTROL-T Trace file. 


Source is a sequential variable-blocked file. 


Target dataset type: 


TRACE 


SEQ 


Twget is a CONTROL-T Trace file. 


Target is a sequential, variable-blocked file. 


The reco11ds written to the output dataset can be filtered by one or mo11e 
INCLUDE/EXCLUDE 
statements. 
For 
more 
informationi 
about 


INCLUDE/EXCLUDE statements, refer to "Logical Field Names for the 


CONTROL-T Repository" in Appendix D. 
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OUTPUT 
Output fo11matting. 


TYPE 


LINESIZE 


Output format type:. 


T 
c 
x 


D 


F 


Trace file reco11ds are unchanged. Default. 


Output contains only pl1intable characters. 


Output is written in1 Hexadecimal format. 


Output is written ini dump format (a. 
combination of C andX types). 


Output is formatted. A comprehensive list 0:6 
Logical 
1 Field' Names and relevant values is 
written, for each volume/dataset record. 


Output record size. Valid values are from 70 to 132 
characters; default is 80; 


Note 
The LINESIZE parameter and C, X, F, and D 
values for the TYPE parameter are only· valid 
when the output dataset is a sequential dataset. 


Return Codes 


0 


8 


12 


16 


20 


Example I 


Operation' ended successfully 


Missing DD statement(s) or open failed 


Control, card error 


Load 0:6 CONTROL-T routines failed 


I/O error on input/output files 


Copy a Trace file to a second' p11eformatted Trace file: 


II 
EXEC 


//SYS'I.N 


CTTACP,TRCOTJT='CTT.BACKUP.TRC' 


DD 
* 


COPY 
FROM=TRACE,TO=TRACE 
II 


Example 2 


Copy the Trace file to a sequential variable-blocked file. Only records from the job 
TAPEJOB are included. The output should be in dump format .. The line size is 132 bytes. 


II EXEC 


//SYS'I.N 


COPY 


'I.NCLUDE 


OTJTPU'J.' 
II 
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CTTACP1TRCOU'J.'=CTT.JOB.ACT:CV'I.TY 


DD 
* 


FROM=TRACE,TO=SEQ 


USERJ:D=TAPEJOB 


TYPE=D,L'I.NES'I.ZE=132 
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CTTAFR - Format and Initialize Trace File 


Utility CTTAFR formats and, initializes the Trace file. 


The required' number of trace records is specified in the TRCSIZE parameter in member 


CTTP ARM. The maximum length 0£ a trace record is 600 bytes. Assuming the dataset 
blocksize is 3600 (the supplied installation default), one 3380 cylinder contains about 1000 


trace records. 


Activating the Utility 


I I 
EXEC 
C'l'TAFR 
II 


Parameters 


No parameters are specified for this utility. 


Return Codes 


0 


8 


Example 


Operation performed success£ully 


DCB open error or TCT load failure occurred 


Fo11mat the Trace file. 


I I 
EXEC 
C'l'TAFR 
II 
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CTTBIX · Rebuild Media Database Index 


This utility rebuilds the index file for the Media Database. The new index file corresponds 
to info11mation 
1 cu11rently contained in the Media Database data file .. 


Notes 
The index file to be rebuilt must be allocated and formatted prior to activating the 
utility. 


CTTBIX will usually run only if CONTROL-T is down or suspended. See parameter 
TYPERUN for further information. 


This utility should be used: 


• When the amount of space remaining for the existing index file is insufficient. In this case: 


- 
Delete the index file. 


- 
Redefine the index file with the requrned amount of space. 


- 
Format the index file. 


- 
Rebuild the index file. 


• For perfomnance imp11ovement. 


• After recovery. 


• After converting volumes fromi other tape management systems (e.g~, CA-1, CA-TLMS) to 


CONTROL-T. 


Activating the Utility 


II EXEC CTTB:CX,'l'YPERUN=BICIF 
II 


Parameters 


Utility parameters are supplied via p11ocedure parameters: 


TYPER UN 
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Statement type. 


B 
Utility is run in BUILD mode; the index file is rebuilt. If 


CONTROL-Tis active, utility CTTBIX willnot run. 


C 
Utility is run in CONVERT mode. This mode is specified when 


converting the database fromi another tape management system to 


CONTROL-T. If CONTROL-Tis active, utility CTTBIX will not run. 
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CTTBIX 


Return Codes 


0 


8 


12 


16 


24 


28 


32 


40 


44 


Example 


F 
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Utility is run in FORCED BUILD mode; the index file is rebuilt. 
No checking is perfo:rnned fol'! CONTROI!r-T status. This mode 


foI!ces building of the index file. 


This value is useful to initiate a rebuild in a test envil'!onment on a 
test Media Database while the production environment is still 
active. 


Utility CTTBIX is run in FORCED CONVERT mode. No checking 
is performed fol'! CONTROl!rT status. This mode forces the 
building of the Index file. 


This mode is specified' when converting the database from another 
tape management system to CONTROL-T. This index file can be 
built and checked in a test envil'!onment while the production' 
environment is still active. 


Note 
Do not use type TYPERUN=F if utility C'ITBLK is running 
on the production Media Database (i.e.,. CONTROL-Tis 


active).. Running this utility· on the production Media 
Database can cause unpredictable results. 


Operation, perfoI!med successfully 


Inconsistency error detected - Execution continues - Index file built 
successfully (Logical errol'!s in the data should be manually col'!rected.) 


Error in parameters - Execution' terminates 


Euo11 opening DCB - Execution, terminates 


Unsuccessful sort 


Media Database access errol'! 


Load of CONTROL-T TCT failed 


Index not empty 


CONTROL-T is active - Utility CTTBIX cannot run in the specified 
mode while CONTROL-T is active 


II EXEC 
C'l'TBZX,'l'YPERUN=B 
II 
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CTTCRDF- Allocate and Format Data/Index Files 


CTTCRDF creates and fo11mats various CONTROL-T files. It can, also increase or decrease 
the size 0£ an index file to provide mo11e space fo11 the file or reduce the space used by the file. 


Activating the Utility 
II 
EXEC CT'l'CRDF 


Other utilities are provided for copying entries from the original data file to the 


newly-fo11matted data file. These other utilities are described' later in this section. 


This utility is used during CONTROL-T installation, by jobs that create CONTROL-T files. 
Each, file creation job builds a newly-fo11matted data file and a corresponding index file. 


Note 
This utility is activated during CONTROL-T installation. 


Parameters 


The11e are two categories 0£ CTTCRDF parameters: Data file par:ameters and Index file 


par:ameters .. Parameters 0£ both catego11ies specif!Y p11ecisely the type 0£ file to be created. 


Pa11ameters are supplied to the utility via a JCL p11ocedure. Each file creation job creates 
and fo11mats a data/index file by receiving one or mo11e of the following parameters: 


Parameters for Data File Creation 


DB PRE FT 


DBVERT 


DBFILET 


DBUNITT 


DBVOI:.T 


NRECS 


NBLKS 
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Highest qualifier 0£ the dataset name, which usually specifies the 


p11efix 0£ the dataset. 


Second highest qualifier of the dataset name, which usually specifies 
the versioni of the dataset. 


Thi11d1 qualifier 0£ the name of the data file to be created. Valid values 
are: 


MDBD 


STKD 


Media Database file 


Stacking Statistics file 


Type 0£ unit on which the data file should reside (3380, 3390). 


Volume on, which the datafile should reside .. 


Number 0:£ reco11ds that the data file should contain. (To calculate the 
required number of records, refer to Disk Storage Requirements in 
1 the 
Considerations section in the IOA Installation Guide.) 


Number 0:£ blocks that the data file should contain. (To calculate the 
required' number of blocks, refer to Disk Sto11age Requirements in the 
Considerations section, in the IOA Installation, Guide.) 
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KEYLEN 


BLK 


LREC 


For data files, KEYLEN is always zero. 


Block size. This value should not be changed. 


Record' length, This value should not be changed. 
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Parameters for Index File Creation 


DB PRE FT 


DB VERT 


DBFlLET 


DBUNITT 


DBVOLT 


NRECS 


KEYLEN 


BLK 


LREC 


NBLKS 


Highest qualifier of: the index file name, which usually specifies the 
prefix of:the index file .. 


Second highest qualifier of the index file name, which usually 
specifies the version' of the index file. 


Third qualifier of the name ofi the index file to be created, Valid values 
are: 


MDBI 


STKI 


Media Database file 


Stacking Statistics file 


Type of: unit on which the index file should reside (3380, 3390). 


Volume on which the index file should reside. 


Number of: recoJ.1ds that the index file should contain. (To calculate the 
required number of: recoJ.1ds, refer to· Disk Storage Requirements in the 
Considerations section in the JOA Installation Guide.) 


Index file's preset key length, This value should, not be changed. 


Block size. This value should not be changed. 


Same as block size length, This value· should not be changed. 


Number of blocks that the index file should contain •. (To calculate the 
required number of blocks, refer to. "Disk Storage Requirements" in 
the Considerations section in: the IOA Installation' Guide.) 


Parameters DBPREFT, DBVERT, and DBFILET specify the name of the file to be created 
(e.g., if DBPREFT is OTT, DBVERT is V500, and DBFILET is MDBI, the name of: the 
newly-created file is CTT.V500;MDBI). 


Return Codes 


0 


8 


12 


16 


20 


24 


28 


32 


Operation perfo:vmed successfully 


Invalid parameters 


LRECL not equalto·BLKSIZE (Index file) 


Open of output file failed 


SYSPRINT open failed 


Insufficient storage (REGION) 


Maximum bfock count was exceeded 


Invalid key length 
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Example 


11 
EXEC C'l''l'CRDF, DBPREF'l'= I C'l''l' I , DBVER'l'= I vsoo ,, , DBF:CLE'l'= • MDB:C • , 


DBUN':C'l"l'=33901KEYLEN=30 


Utility CTTCRDF is used by the followingjobs in, the IOA INSTCTT libvary. Refer to these 
jobs fov additional examples. 


CTTCMDB 


CTTCSTK 
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Allocates and fovmats the Media Database file (described in detail in1 
the IOA Installation Guide). 


Allocates and fovmats the Stacking Statistics file (described in detail 
in, the IOA Installation' Guide). 
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CTTCTRC - Allocate and Format Trace File 


CTTCTRC creates and formats CONTROb-T Trace files. 


Activating the Utility 
II EXEC C'l'TC'1'RC 


This utility is used during CONTRO!'..-T installation by the job that creates the 


CONTROL-T Trace file. 


Parameters 


Parameters are supplied' to· the utility via the in:vocation1 0£ a JCL procedure. 


Parameters for Data File Creation 


DBPREFT 


DB VERT 


DBUNITT 


TRCVOL 


TRCBLKS 


Highest qualifier 0£ the dataset name, which usually specifies the 
prefix of the dataset. 


Second highest qualifier 0£ the dataset name, which usually specifies 
the version 0£ the dataset. 


Type o£unit on, which the file should reside(3350, 3380, 3390). 


Volume on which the file should reside. 


Number 0£ blocks that the Trace file should contain. (To calculate the 
required number of blocks, refer to "Disk Storage Requfrements" in 
the Considerations section in' the IOA Installation Guide.) 


Parameters DBPREFT and. DBVERT specify the name of the file to be created (e.g., if 
DBPREFT is CTT and DBVERT is V500, the name of the newly-created file is 


CTT.V500.TRC). 


Return Codes 


0 


8 


Example 


Operation' performed successfully 


DeB open erro11 or CONTROL-T Control table load failure 


11 
EXEC C'l'TC'1'RC,DBPREF'1'= 'C'l'T' ,DBVER'1'= •vsoo·· ,DBUNJ:'l'T=33901 


'1'RCBLXS=1700 
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CTTDBDLD - Load.Media Database/Stacking Statistics File 
Data Components 


Utility CTTDBDLD loads Media Database (MDB) ov Stacking Statistics file data 
components from a sequential file (which was pveviously created by utility CTTDBDlJL). 


The data file must be formatted via utility CTTDBF before running this utility. 


Note 
The Media Database index component can be rebuilt from the data component of the 
database using utility CTTBIX. The Stacking Database index component can be 
rebuilt using utiUty·CTTDBIB. 


Activating the Utility 
II EXEC C!l'TDBDLD 


Parameters 


The following par:ameters can be specified to the utility in the EXEC statement which 
invokes the CTTDBDLD JCL procedure: 


DB FILE I 


DBFILEO 


Return Codes 


0 


8 


12 


16 


20 


100-199 


200-299 


Example 


Sequential file name suffix (input). 


Output file name suffix. Valid values are: 


MDBD 


STKD 


Media Database file 


Stacking Statistics file 


Operation pe:vformed successfully 


Sequential file operation error 


Insufficient storage (REGION) 


Invalid parameters 


IOAP ARM load failed 


Index component errors 


Data component errors 


II EXEC C!l'TDBDLD,DBF~LE~=SEQ,DBF~LEO=MDBD 
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CTTDBDUL · Unload Media Database/Stacking Statistics 
File Data Components 


Utility CTT12>BDUL unloads Media Database (MDB) or Stacking Statistics file data 
components to a sequential file .. The sequential file must be previously allocated as fixed 
block, with a record length equal' to the record length 0£ the database file being unloaded. 


Activating the Utility 
II EXEC C'l'TDBDUL 


Parameters 


The following parameters can be specified to the utility in the EXEC statement which 
invokes the CTTDBDUL JCL procedure: 


DBFILEJ, 


DBFILEO 


Return Codes 


0 


8 


12 


16 


Example 


Third qualifier of: the input dataset. Valid: values are: 


MDBD 


STKD 


Media Database file 


Stacking Statistics file 


Sequential file name suffix (output). 


Operation performed successfully 


File operation erroIJ 


Insufficient storage (REGION) 


IOAPARM load failed' 


II EXEC CTTDBDUL,DBFXLEX=MDBD1DBFXLEO=SEQ 
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CTTDBF - Format Existing Data/Index Files 


This utility fo11mats an existing CONTROL-T data or index file. 


Note 
Utility· CTTDBF is similar to· utility CTTCRDF (described in this section). However, 
utility CTTDBF does not actually create data/index files. The files must exist on the 
disk before the utility is run. 


Activating the Utility 
II EXEC CT'l'DBF 


Parameters 


The following paiiameters can be specified to the utility in the EXEC statement which 
invokes the CTTDBF JCL procedure: 


DBFILET 


NRECS 


KEYLEN 


Return Codes 


0 


8 


12 


16 


20 


24 


28 


32 


Example 


File name suffix.Valid values are: 


MDBD 


MDBI 


STKD 


STKI 


Media Database Data file 


Media Database Index file 


Stacking Statistics Data file 


Stacking Statistics Index file 


Number 0£ records. This number should .be the same number that utility 


CTTCRDF received via parameter NRECS when, the file was created. 


Record key length. This number should be the same number that 
utility CTTCRDF received via parameter KEYLEN when the file was 
created. Fo11 data files, KEYLEN is always zero, 


Operation performed successfully 


Invalid parameters 


LRECL not equal to BLKSIZE (Index file) 


Open of output file failed 


SYSPRINT open failed 


Insufficient storage·(REGION) 


Maximum block count was exceeded 


Invalid key length 


II EXEC C'l'TDBF,DBF:CLET=STKD,NRECS=lOOO,KEYLEN=O 


See the followingjobs in the JCL library fo11 additional examples. 


CTTFMDB 


CTTFSTK 
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Formats Media Database data and index files. 


Formats Stacking Statistics data and index files. 
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CTTDBIB · Rebuild Indexes of Stacking Statistics File 


Utility CTTr>BIB rebuilds an index file from the CONTROL-T Stacking Statistics Data 
file. The new index file corresponds to information currently contained in the Stacking 
Statistics Data file. 


Previous contents of the index file are erased. 


Note 
The index file to be rebuilt must be allocaf;ed andformatted prior to activating the utility. 


This utility should be used: 


• When the amount of space remaining in' the existing index file is insufficient. In this case: 


- Delete the index file. 


- Redefine the index file with the required amount of space. 


- Format the index file with utility CTTDBF. 


- Rebuild the index file with utility CTT1'BIB. 


• Performance improvement. 


Activating the Utility 
II EXEC C'l"l'DB:I:B 


Parameters 


The following parameter can, be specified to the utility in the EXEC statement which 


invokes the CTTDBIB JCL procedure: 


DBFI'LET 
Data file name to be processed. Valid values are: 


STKD 
Stacking Statistics Data file 


Note 
SYSIN parameters are provided in the KEYxxx members in the PAR,M library for your 
convenience. Relevant file name specifications are hard-coded (predefined) in these 
members. 


Return Codes 


0 


other 


Example 


Operation' perfo11med successfully 


Operation failed 


II EXEC 
CTTDB:I:B:,DBF:I:LET=STKD 


I I SYS:I:N 
DD 
DSN=CTT. PROD• PARM ( KEYSTK) ·, D:I:SP=SHR 


llDA:I:DXSTK DD 
DSN=CTT.PROD•S'l'K:I:,DJ:SP=SHR 
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CTTDBID - Check Integrity of Data File 


Utility CTTDBID checks data file integrity. 


Utility CTTDBID checks the ph!Ysical or:ganization of a data file and repoJ.lts erro11s which 
are detected in the data file structure. If specified, the utility corrects erro11s that are 
detected. 


Activating the Utility 
II EXEC C'l'TDB:CD 


Data file integrity errors are listed in the sysout 0£ the job: 


Parameters 


The following parameters can be specified to the utility in the EXEC statement which 
invokes the CTTDBID JCL procedure. 


DBFILET 


ACT 


Return Codes 


0 


other 


Example 


Third qualifier of the name of the data file to be processed. Valid 
values are: 


MDBE> 


STKD 


Media Database file 


Stacking Statistics file 


Action to be perfo11med on' the file. 


R 
Report on detected errors 


W 
Report on and correct detected errors 


Note 
It is recommended that utility· CTI'DBID be run first with 
ACT=R (i.e., without requesting correction). If, based on such a 
run, it is determined that corrections· are necessary, rerun the 
utility· with ACT= W (i.e., requesting corrections). 


Operation performed successfully 


Operation failed 


ll EXEC C'l''l'DB:rD,DBF:CLE'l'=MDBD,AC'l'=R 
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CTTDBII - Check Integrity of Index File 


Utility CTTDBII checks index file integrity. 


Utility CTTDBII checks the physical 011ganization of an index file and reports erro11s that 
are detected in the index file structure. 


If erro11s a11e detected, the co11responding index file should be rebuilt using utility 


CTTDBIB (or: utility CTTBIX if the file is the Media Database file). 


Activating the Utility 


II EXEC CT'l'DB:CJ: 


Index file integrity erro11s are listed in the sysout of the job: 


Parameters 


The following parameter can be specified' to the utility in, the EXEC statement which 
invokes the CTTDBII JCL p11ocedure: 


DBFILET 


Return Codes 


0 


other 


Example 


Third qualifier: of the name of the index file to be processed. Valid 
values are: 


MDBI 


STKI 


Media Database file 


Stacking Statistics file 


Operation performed. successfully 


Operation failed 


II EXEC CT'l'DB:CJ:,DBF:CLE'l'=S'l'KJ: 
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CTTDBPRT · Print Data Records 


This utility prints any CONTRO!rT data file and its coriresponding index file in SNAP format. 


Activating the Utility 
II EXEC CTTDBPR'l' 


Parameters 


The following parameters can be specified to the utility in1 the EXEC statement which 
invokes the CTTDBPRT JCL procedure:. 


DBFILET 


FROM 


TO 


Example 1 


Third qualifier of the name of the data file. Validvalues are: 


MDB 
Media Database file 


STK 
Stacking Statistics file 


Value of key from which to print. 


Value of key until which to pllint. 


Notes 
This· utility works· with a pair of files (both data and index files). 


Parameters FROM and TO are keys that should be found in the 
index and according to which data are printed; 


The actual key is prefixed with one byte which identifies the 


record type: 
D 
Dataset 


V 
Volume 
K 
Stacking 
Either FROM and TO, or neither FROM nor TO can be specified. 
If FROM and TO parameters are not specified or are specified as 
blank, all records are printed. 


Print the entire Media Database file; 
II EXEC CTTDBPR'l',DBFXLE'l'=MDB 


Example2 


Print the Media Database volume records fo11 volumes 100,000 through 999,999. 


I I EXEC· CTTDBPRT, DBFXLET=MDB, FROM=V10 00 0 0 '1 TO=V99 99 99 · 


Example 3 


Print the Media Database dataset reco11ds fo11 datasets BACKUP.G0012VOO th11ough 
BACKUP9. 
II EXEC CTTDBPR'l',DBFXLET=MDB,FROM=DBACKUP.G0012V001TO=DBACKUP9 


Example 4 


Print the Stacking Statistics file reco11ds created by job M77BKUP. 
II EXEC CTTDBPRT,DBFXLET=STK,FROM=KM77BKUP,TO=KM77BKUP 
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CTTDLD - Add/Delete/Convert Volumes 


This utility adds volumes to, and deletes volumes from, the Media Database. It can also 
convert volumes from other tape management systems (e.g.,. CA-1, CA-TCMS). 


This utility should be used: 


• To add, a range of scratch/non~scratch volumes to the Active library (MAINLIB). Reco11ds for 
these volumes are added to the Media Database. This is called ADD mode. 


• To delete a range of scratch volumes from the Active Lib11ary (MAINLIB). Records for these 
volumes are deleted from the Media Database. This is called DELETE mode. 


• To build data from an, external source of information and add it to the data component of the 
Media Database .. This is called CONVERT mode .. Usually CONVERT mode is used to convert 
another tape management systemls database (e.g;,.CA-1, CA-TLMS) to CONTROL-T. 


Activating the Utility 


ADD mode: 


II EXEC 


llSYS'X.N 


TYPER UN 


RANGE 


II 


CTTDLD· 


DD 
* 
MODE=ADD 


Fl:RST=firstvol,LAST=lastvol,MEDI:A=type, 


SCRATCH=YJN,VENDOR=vendor,RENAME=prefix 


DELETE mode: 


II EXEC 


llSYS'X.N 


TYPER UN 


RANGE 


II 


CTTDLD 


DD• 
* 
MODE=DELE'l'E 


Fl:RS'J.'=firstvol,LAST=lastvol 


CONVERT mode: 


II 
EXEC 


llSYSIN 


TYPER UN 


RANGE 


II 


CTTDLD,INP=•source-dataset• 


DD 
* 


MODE=CONVERT 


FIRST=firstvol,LAST=lastvol,MEDIA=type, 


VENDOR=vendor,RENAME=prefix 


Note 
Parameter INPin procedure CTTDLD is mandatory and valid onlyin CONVERT mode. 


Utility CTTDLD is used by the following jobs in the INSTCTT library. Refer to these jobs 


fo11 additional examples. 


CONVTMDB 
Converts CA-TLMS Tape Management System repo11ts to the 


CQNTROL-T Media Database. 


IOA Rel 5.0.0 Administrator Guide 
9-127 


Section 9: Utilities 
CTTDLD 


CONVC4MD/CONVC5MD 


CONVLCTL 


CONVRMDB 


Parameters 


Converts from CA-1 (versions 4 or 5, respectively) to the CONTROL-T 


Media Database. 


Converts from: MVS Catalog to the CONTROL-T Media Database. 


Converts from:RMMtothe CONTROL-T Media Database. 


The following parameter is specified in the EXEC statement: 


INP 
Name 0:£ the input file containing the data to be converted;. Mandatory 
and valid only in CONVERT mode. 


The following parameters are supplied via DD statement SYSIN: 


TYPER UN 
Statement type ... 


MODE 
Operation mode. 


ADID 
Add volume entries to the Media Database. 


DELETE 
Delete scratch volume entries from the Media 


Database:. 


CONVERT Convert volume entries from: another tape 
management 
product's 
database 
to· 


CONTROL-T Media Database format. 


The following parameters are supplied in the RANGE statement: 


RANGE 
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Statement type 


FIRST 


LAST 


MEDIA 


SCRATCH 


VENDOR 


RENAME 


First volume serial number in the range. Mandatory. 


Last volume serial1number inthe range. Mandatory. 


One of the media types defined' in, member CTTPARM. 
Mandatory and valid only in·ADB and CONVERT modes. 


Indication, 0:£ whether or not the volume should be added 
as scratch~ Valid for: ADD mode only. Optional. 


Y (Yes) 


N(No) 


Volume should 1 be added as scratch; 


Volume should not be added as scratch; 


Vendor 0:£ the media. Optional. Valid only in ADJD and 


CONVERT modes. 


A string used to. replace the p11efix 0:£ the volume serial 
number (volser). The SL-name of the volume remains 


unchanged, Optional, RENAME=prefix is valid only in 
ADD and. CONVERT modes. The length of this string 
must not exceed the length of the coITesponding part of 
the FIRST and LAST p11efix. 
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Return Codes 


0 


4 
12 
16 


Operation performed successfully 


Minor errors occurred - Operation continues 
Error in' parameters - Execution terminates 
Error opening DC!::B - Execution' terminates 
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Greater than 16 
Other error - the error is accompanied by ani appropriate message 
indicating the problem - Executioni terminates 


Example I 


Add 3400 type media non-scratch volumes numbered K00100~K00500, made by vendor IBM. 


II 
EXEC 
CTTDLD 
//SYSIN 
DD'* 


TYPERUN 
MODE=ADD 


:RANGE 


II 


Example 2 


P':CRST=K00100,, LAST=KOOSOO•, MED:IA=34001 
SCRATCH=N,VENDOR=:CBM 


Delete volumes numbe11ed K00100-K00500• 
II 
EXEC 


//SYS:CN 
CTTDLD 


DD * 


TYPERUN 
MODE=DELETE 


:RANGE 
II 


Example3 


F:CRST=K001001,LAST=K00500' 


Convert 3480. type volumes numbered' K00100-K00500 to CONTROL-T. 
II EXEC 


llSYS:CN 
CTTDLD,:CNP='TAPE.CONVERT' 


DD * 


TYPERUN 
MODE=CONVERT 
:RANGE 
F:CRST=KOO!L00,LAST=K005001MED:IA=3480 
II 


Example4 


If you are consolidating two tape libraries and both libraries contain tapes with the same 
volsers, you can rename the volsers for one set of tapes so that no conflict will appear in 
the Media Database. 


In this example, active volumes 0£ the 3480 media type made by vendol' IBM with volsers 


FX0001-FX0100 we converted to CONTROL..-T, renamed, and added to the Media Database. 


Volsers FX0001-FX0100 are renamed MAOOOl-MAOlOO: The SL-names (the internal, !ables 


0£ the volumes) remain' FX0001-FX0100. 
II 
EXEC 


//SYSIN 
CTTDLD· 


DD• * 


TYPERUN 
MODE=CONVERT 
:RANGE 
F:CRST=FX0001,LAST=FXO!L001MED:IA=3480, 
VENDOR=:CBM,RENAME=MA 
II 
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CTTGVL - User Interface to Stacking Facility 


Utility CTTGVL assigns a volume to a given dataset before the dataset is allocated. The 
utility returns a volume serial number (according to user specifications) for the file that 
the user wishes to create. 


To select the appropriate volume, the utility scans the CONTROL-T rules (acconding to 
supplied parameters) so that the volume which is returned is allocated from the 


approp:r:iate pooli. 


The utility can optionally activate the CONTROL-T Stacking Facility, which searches the 
Media Database to locate avolume which1has enough free space to hold the new file. Upon 


user request, 011 if such a volume cannot be located 
1 
, a scratch' volume can, be returned 
instead. 


Utility CTTGVL uses the active CONTROL-T environment (in ECSA). Therefore, the 
utility can be called only on a CPU oni which the CONTROL-T envfoonment is initialized. 


The utility requires APF autho:riization. Thenefore, it must reside ini an authorized libl'ary, 


and the load module that contains it (if linked to the user program~ must also be 
authorized (AC=l). 


Activating the Utility 


This utility is not a standalone utility. It must be called by an application using one of the 
following methods. See sample CTTGVLD in the IOA SAMf>LE libl'any. 


Using a Call Command 


CALL CTTGVL, (dataset, Job name, stackid,.volser, label) , VL 


Using a Link command 


L:CNK EP=C'l''l'GVL, PARAM= (dataset, Job· name, stackid, volser, label)·, VL · 


Parameters 


Utility CTTGVL receives parameters in the standard method (Register 1 points to a list of 


addresses). The following parameters should be passed to the utility: 


Input Parameters 


DATASET 


JOB NAME 


STACKID 
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Name of the dataset. A maximum of 44 characters can be specified. 


Mandato11y. 


Name of the job. A maximum of eight characters can be specified. 


Optional. 


Indicaton (one chal'acter in length) specifying whether stacking is 
enabled/disabled= 


Y (Yes) 


N(No) 


Stacking is enabled. 


Stacking is disabled. 
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Output Parameters 


VOLSER 


LABEL 


Volume serial number. Six characters must be specified. 


Hexadecimal representation (two bytes in length~ ofi the label' number. 


Return Codes 


Function completed successfully 


No matchingvolume found 


Invalid stacking indicator 


CONTROL-Tis not active 


0 


4 


8 


12 


16 
Database access failed- a detailed message can be found in the job log 
or system log 


Example 


This utility must be called' from an, application program using one ofi the follbwing 
methods: 


Using a Call command: 


CALLC'l''l'GVL,(DSN,JOBNAME,S'l'ACK:CD,VOLSER,LABEL),VL 


Using a Link commandc 


LJ:NK EP=C'l"l'GVIl,PARAM=(DSN,JOB·NAME,S'l'ACK:CD,VOIISER,LABEL),VL· 


Assume the following definitions for either o:t: the above methods: 


DSN 
DC 


JOB.NAME 
DC 


S'l'ACK:CD 
DC 


VO II SER 
DS 


LABEL· 
DS 


CL44'MY.DSN' 


CL8'MYJOB' 


C'Y' 


CL6 


H 
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Dataseti name 
Job name 
Stacking indicator 


Volume serial number 
Label 
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CTTIDB - Check Integrity of the Media Database 


Utility CTTl'.DB checks the integrity of the Media Database (MDB) and p11ovides statistical 


info11mation, Wa11ning messages are p11ovided if database inconsistencies are detected. 
Upon user request, CTTIDB p11oduces a transaction, file which can be used by utility 


CTTUDB to repair some types of detected inconsistencies. 


These inconsistencies may occur during conversion from. another database, 011 as a result of 
system crashes, utility abends, etc., dm~ing p11ocessing. 


Examples of inconsistencies a11e: 


• Erro11s in the chain links which connect volumes in a multi-volume chain 


• Existence of active volumes which do not contain datasets 


• Existence of scratch volumes which contain, datasets 


• Discrepancies between various Media Database reco11ds 


Upon completioni utility CTTIDB provides statistics about the· Media Database. The utility 
can be run for statistical purposes. The statistics p11ovided include: 


• Number of used datarecords 


• Number of used index reco11ds 


• Number of free data reco11ds 


• Number of free index records 


• Totals by type of records (volume, dataset, scratch) 


It is recommended that this utility be run' immediately after conversion: from another 
database, after a system crash, or after a CONTROL-T utility abends during processing. 
This utility can be run whenever Media Database statistics are desired. 


Activating the Utility 


Note· 
The SYSIN statement and the MTU parameter are optional. 


II EXEC 
C'l'TZDB,MTU='transaction-file' 


llSYSZN 
DD* 


'l'YPERUN 
MODE=CHECKIUPDATE{,USEDAYS=n} 


Parameters 


The following paramete11 can be specified in the EXEC statement: 


MTU 
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Name of the transaction, file to, be used by utility CTTUDB. Optional. 
If not specified, an installation-defined default is used. 
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The following parameters are supplied via DD statement SYSIN: 


TYPER UN 


Return Codes 


0 


8 


12 


16 


Greater than 16 


Example 


Statement type. 


MODE 


ClilECK 


UPDATE 


USEDAYS 


Operation1 mode. Mandatory. 


Only messages about inconsistencies 
a:r:e 
provided. 
Default. 


Transaction1 records for utility CTTUDB are provided in 
addition to inconsistency messages. 


Threshold number of days since the volume was last 
accessed. (For MOBE=UPBATE only.) For those volumes 
not accessed since the specified number of days have 
passed, transaction records are generated for utility 


CTTUDB to remove the IN-USE indication from the 
volumes.. Appropriate messages are also generated, 


Default is 7 (days). 


Operation perfo11med successfully 


Problem detected in the Media Database - Execution continues 


Invalid control: parameter given - Execution' terminates 


Error opening DCB - Execution terminates 


Severe erro11 - the erro11 is accompanied by an1 appropriate message 
indicating the p11oblem - Execution terminates 


In: the following example, utility CTTIDB p11oduces a transaction file of problems and 
issues appr:opriate messages .. It also pr:oduces transaction· records which remove the 


IN-USE indication1 from every volume which has not beem accessed fo11 more than 6 days. 


II EXEC 


//SYSIN 


CTTIDB 


DD * 


TYPERUNMODE=UPDA'l'E, USEDAYS=6 · 
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CTTMER - Merge Records Into the Media Database 


Utility CTTMER is used to merge Media Database records into a target Media Database 
via an extract file created by utility CTTSPL. 


Notes 
There is no need to shut down CONTROL-T while running this utility. 


Utility CTTMER is used together with utility· CTTSPL in the split and merge process. 
Refer to the "The SPLIT and MERGE Process" in the description of the CTTSPL utility 
in this section before using utility·CTTMER. 


After execution of utility· CTTMER it is highly recommended that you run utility 
CTTVTM in SLOTBLD mode to rebuild the· slot definitions. After completion of utility 
CTTVTM use utility CTTIDB to check the integrity of the target Media Database. 


Utility CTTMER automatically updates the Media Database index component .. There 
is no.need to·run utility CTTBIX after the run of this utility. 


Activating the Utility 


II 
EXEC C'l'TMER,MRGIN=repdata-file 


//DAIN 
DD * 


TYPERUN MODE=NORMAL I S:cMULATE I RS:tMO'LAT [I DBGLEVEL=XXX]. 


I* 


Parameters 


repdata~file 


TYPER UN 
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Extract file created by utility CTTSPL. The name of this file is 
supplied via parameter MRGIN. Mandatory. 


The 
extract 
file 
is 
a 
pI'edefined 
sequential 
file 
(olpre£t.olvert.REPDATA) allocated, as one of the CONTROL-T 


operations libraries at time of CONTROL-T installation, (at the site 
containing the source Media Database). 


The TYPERUN statement is specified via DD statement DAIN. The 
format fo:11 this statement is: 


TYPERUN MODE=NORMALIS:IMUIIATEIRSIMULAT[,DBGLEVEL=XXX] 


Where: 


MOBE 
Operation mode. Mandatory. 


NORMAL 
Normal 
1operationmode. Default. 


SIMULATE 
Simulation mode. No changes are made to 
the Media Database. Messages describing 
the· simulated operations are sent to the 
utility log. 
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RSIMULAT 
Restart simulation. If a first run of utility 
CTTMER abended, the utility can be rerun 
in this mode prior to rerunning it in 


NORMAL mode, and thus causing an 
automatic restart. Only the deletion of 


reco:vds already merged into the Media 
Database is simulated. 


Note 
Only the deletion of data records,. V-keys, D-keys 
and T-keys is simulated. Deletion of L-keys is not 
simulated. 


DBGLEVEL 
Debug level. A numeric value from 1 to· 255 can. be 


specified, Optionah 


Note 
This parameter should only· be used if requested 
by your JOA representative. 


Example 


In 
this 
example 
utility 
CTTMER 
merges 
all 
reco:vds 
in 
the 
extract 
file 


(CTT.V500.REPDATA) into the Media Database. 


II 
EXEC C'l"l'MER1MRG:CN=C'rT.VSOO.REPDA'l'A 
llDA:IN 
DD * 


'l'YPERUN MODE=NORMAL 
I* 


Return Codes 


0 
Operation perfo11med successfolly 


8 
Initialization problem. 


12 
Merge· failed· - some of the reco11ds to be merged already exist in the 


ta:vget Media Database 


16 
Unable to access the resta11t information from the Trace file 


20 
Simulation• mode is not allowed while restart is required 


24 
Another utility is currently executing - the Media Database is locked 


28 
Restart p11ocessing failed 


Greater than 28 
Severe error - the error is accompanied by a message describing the 


p11oblem 
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CTTMUP - Manually Update the Media Database 


Utility CTTMUP updates fields of a volume 011 dataset reco11d in the Media Database 
(MDB). Update is performed independently fol' volume and/ol' dataset reco!'ds. When 
updating a volume reco11d, CTTMUP does not automatically update the corresponding 
dataset recol'ds, and vice versa~ (Fo11 example, the dataset count in a volume reco!'d is not 
updated when CTTMUP adds a dataset.) Therefore, when using this utility, be sur:e to 
update all connected records. 


When a dataset is added, the utility searches the rules (as if the dataset is being created 
on removable media) to determine retention and' vaulting criteria to be assigned to the 
dataset and the volume containing the dataset. Refer to "Manual Update of the Media 
Database" in Section 7 of this guide fol' a general description of this utility. 


Notes 
Utility CTTMUP is an extremely powerful utility which modifies your database. Great 
care should be taken that it is being used correctly. Therefore, before specifying 
parameters for use by this utility; read the section "Special Notes Regarding Control 


Statements" following theparameter descriptions; 


Before using utility·CTTMUP, it is·important to.familiarize yourself with the structure 
ofthe·Media Database (described in Section 7 of this·guide) .. Attempting to·update the 
Media Database with proper understanding of the Media Database structure can lead 
to.integrity ·errors. 


Activating the Utility 


II 
EXEC 


l/SYS:CN 


'l'YPERUN' 


CTTMUP 


DD, * 


MODE=NORMAL I S:CMOLATJ:ON [I RULEI,NFO=YES I NO] [, CHECK=YES I NO] 


[,APPIIY=GROUP] 


<CONTROII STATEMENTS> 


Parameters 


TYPER UN 
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Operation: type. 


MODE 
Operation Mode .. Mandatory. 


NORMAL 
Normal operation, is performed. 


SIMULATION 
Simulation mode is perfol'med. 


RULEINFO 
Whether or not to apply rule information (e.g~, Retention 
criteria) when adding, a dataset to the Media Database. 


YES 


NO 


Apply the rule information: to. the Media 
Database record. Default. 


Do not apply the information to the 
Media Database record. 
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Whether or not to check Media Database integrity after 
performing the requested changes. 


YES 


NO 


Check the integrity of the Media 
Database. Default. 


Do not check the integrity ofi the Media 
Database. 


Determines which volumes wm be affected by the OLUPD 


control statement. Optionah 


The VOLUPr> statement is applied to alll volumes in the 
multi-volume chain containing the volume specified in the 


VOLSER field of the VOI!,UPr> statement. 


Note 
If parameter APPLY is not specified,. the VOLUPD 


statement is applied only· to ·the volume specified in 
the VOLSER field of the VOLUPD statement. 


Control Statements 


Control: Statements specify the update function to be perfo11med, the Media Database fields 
to be updated and the update values. Some functions are valid for volume type records 
only, and some·functions are valid for dataset records only. 


Valid Control1 Statement functions are listed below, followed by information on specifying 
fields and values. 


Note 
Fields which can be updated by this utility are listed in Table 1 and Table 2 in 


"Logical Field names for the CONTROL-T Repository" in Appendix D. (They are the 
same fields that can be specified in INCLUDE I EXCLUDE statements of other 
utilities.) 


VO LADD 


VOLUPD 


VOLD EL 


Add volume. One field, is mandatory for this function: 


VOl.SER 
Volume serialnumber. 


Update volume .. The VOLSER field is mandato11y for this function: 


VOLSER 
Volume serial number. 


Delete volume. The volume to be deleted must be identified by one of 
two fields (either field is mandatory): 


Either: 


VOLSER 
Volume serialnumber. 


011: 


DVLRBA 
Internal CONTROL-T reco11didentifie11. 


If DVLRBA is used to identify the volume, VOLSER can be used for 
verification. 
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VOLSCR 


VO LB IX 


GRPSCR 


GRPBIX 


DSNUPD 
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Delete all the datasets in the volume and change the status of the 
volume to scratch, One field is mandato11y fol' this function: 


VOl!..SER 
Volume serialnumber. 


Rebuild the indexes of a volume and of all its datasets .. The volume 
must be identified by one oftwo fields (either field· is mandato11y): 


Either: 


VOLSER 
Volume serial number. 


011: 


DVLRBA 
Internal CONTROL-T record identifier. 


If DVLRBA is used to identify the volume, VObSER can be used fo11 


verification, 


Delete alli datasets of all the volumes in the group, and change the 
status of those volumes to scratch. One field· is mandatory fo11 this 
function: 


VOLSER 
Volume serial number of one of the volumes in the group; 


Rebuild the indexes of all the volumes and of all the datasets in the 
group .. One of the volumes in the group must be identified by one of 


two fields (either field is mandatory): 


Either: 


VOLSER 


011: 


DVLRBA 


Volume serial number of a volume in the group. 


Internal CONTROL-T reco11d identifier of a volume in the 
group. 


If DVLRBA is used to identify the volume, VOl!..SER can be used for 
verification. 


Update dataset record. The reco11d to· be updated must be identified in 
one of two ways (either set of fields is mandato11y): 


Either: 


DSVOLSER 
Dataset's volume serial number. 


DSLABEL 
Dataset's label number (file sequence) .. 


011: 


DDSRBA 
Internal CONTROL-T record, identifier. 


If DSNAME is specified, it is used for verification only. The dataset 
name cannot be modified·. 
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Update dataset name (the DSNAME field. in 1 the dataset record). Only 


the parameters shown below al'e valid for this control statement. 


NEWNAME 
New dataset name. Mandatory. 


DSNAME 
The Clll'!rent dataset name (befo11e update). This parameter 
is used fol' verification only. The dataset cannot be 


modified~ 


The recol'd to be updated must be identified in one of two ways (either 
set of fields is mandato11y): 


Either: 


DSVOLSER 
Dataset's volume serial number. 


DSLABEL 
Dataset's label number (file sequence). 


or: 


DDSRBA 
Internal CONTROL-T record identifier. 


Add dataset reco11d. Th11ee fields are mandatory for this functionc. 


DSVOLSER 
Dataset's volume serial number. 


DSLABEL 
Dataset's label' number. 


DSNAME 
Dataset name. 


Delete dataset record~ The reco11d to be deleted must be identified in 
one of two ways (either set of fields is mandatory): 


Either: 


DSVOLSER 
Dataset's first volume .. 


DSLABEL 
Dataset's label number. 


011: 


DDSRBA 
Internal CONTROL-T record identifier. 


If DDSRBA is used to identify the reco11d, DSVOLSER and DSLABEL 


can be used for vel1ification. 


If DSNAME is specified, it is used fo11 verification· only. 


Delete L-type key for a volume. Two, fields are mandato11y for this 


functionc 


DSVOL..SER 
Dataset's volume serial' number. 


DSLABEL 
Dataset's label, number. 


Delete Media Database reco11d (any type). One field' is mandatory fo11 


this functionc 


RBA Internal CONTROL-T record identifier. 
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RECUPD 


UPDQNM 


VOLSCRF 
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Modify records 0£ an:v type in the Media Database (e.g., Restart 
Control' reco11ds, Slot Definition, records). 


This function includes the following control' statements: 


RECUPD RBA=rba 


VER 
offset data 
REP 
offset data 


ENDUPD· 


Statement RECUPD selects a records from the Media Database for 
update. It must be the first statement specified. This statement 
includes the following parameters: 


RBA 


VER 


REP 


ENDl!JPD 


Internal CONTROL.-T record identifier of the record to be 
updated. 


Identifies existing data to be verified before updating the 


reco11d. 


Identifies the new datathat should replace existing data; 


Identifies the end of the RECUPD function. It must be the 
last statement in' this function, 


An unlimited number of paired VER and REP statements can, follow 
the RECUPD statement. These statements are formatted like the VER 
and REP statements 0£ MVS utility AMASPZAP: 


Data is p11ovided in both the VER and REP statements, as follows: 


offset 


data 


Example 


Offset of the data from the beginning of the reco11d (four 
digits in hexadecimal format, from 0000.to.OlCC). 


Record 
data for 
verification 
011 
replacement 
(in 
hexadecimal ZAP format). 


This example updates the volume reco11d with RBA=000104. Two 
status bytes are verified on offset 0005, and status IN-USE then, set. 


RECUPD 


VER 


REP 


ENDUPD 


RBA=X000104 
0005 80001 
0005 soorz 


Change the QNAME in the Media Database (i.e., in: the following files: 
MDBD, MDBI, TRC, STKD, STKI). One field is mandatory fo11 this 
function: 


QNAME 
NewQNAME. 


Scratch a volume in the Media Database regardless of integrity errors. 


One field is mandatory for this functionc 


VOLSER 
Volume serial number. 
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Special Notes Regarding Control Statements 


Note 
Be sure to read the following notes before specifying control statements for this utility. 


Function VOLBll 


This function, is intended for use only when utility CTTI'DB detected erro11s with V-indexes 
(volume indexes). This function should not be used for L-index problems. 


Function GRPBll 


Be sure that you have corrected an V-indexes befo11e using this function. 


This function corrects all p11oblems 0£ L-indexes and D-indexes. It can be applied fo11 a 
single volume as well as for a multi-volume group. 


Function VOLUPD 


• When this function' is used to update fields MEDIA, LOCATION or SL.OTNUM of the 
volume, the slot in which a vaulted volume resided remains in status IN USE .. 


In' this case, to· synchl1onize the Slot Definition' Records in' the Media Database, run utility 
CTTVTM with the following control1 statement: 


'l'YPEVLT MODE=SLOTBLD 


• A single status bit can, be set in, a specific· status byte 0£ a volume/dataset reco11d. 


For example to turn on status PVLT (Potential Vault) on, a volume reco11d, include the 
following statement: 


VOLUPD:.., •• , VOL:CND=+PVLT 


To,turn,offthe above status bit include the following: 


VOLUPD ••••• ,VOL:CND=-PVLT 


Function VOLSCRF 


This function is intended' for use only after integrity errors occurred while trying to 
scratch records via function VOLSCR or GRPSCR. 


This function affects single volumes only. To scratch a multi-volume group, specify this 
function. for each volume separately. 


Specifying Fields and Values 


The following points should be considered when specifying fields and values fo11 this utility: 


Date Fields 


Time Fields 


Numeric· Fields 


Embedded Blanks 


Format is yymmdd 011 yyyymmdd. 


Format is hhmmss. 


Leading zeroes are not requi11ed~ 


Should only be used if the value is enclosed in1 either single or 
double quotes. 
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Quotation1 Mavks (' or ") 
If the value begins and 
1 ends with either single or double 
quotes, the quotation1 marks are interpreted as mar:kers ofi the 
beginning and end of the value;. To· include a quote mark in a 
string (value); use the other type ofi quote mark to mark the 
beginning and end ofi the string. For example, a single quote 
(apostrophe) can only be included in the value if the value is 
enclosed in double quotes("). 


NuUValues 
Specify a null value fo11 a field by specifying the field without 
a value (e.g., VO!'...SER,). 


Retention1 Criteria Fields 
Specification ofi retention' criteria requires two fields/values: 


- Retention' type .. 


- Retention data; 


If retention 
1 data is specified without specifying the retention 
type, the retention type defaults to DATE. 


Fields with Predefined 


Valid Values 
Certain fields have a predefined set ofi valid values (e.g., 
valid values for field· VOLSTAT are ACTIVE, VAULTED). 


Status Bits 


Valid values for these fields are listed in Table 1 and Table 2·in 
"Logical Field 1 Names for the CONTROL-T Reposit.ory" in 


Append:iKD. Values can also be specified in1hexadecimal format 


(e.g;, VOLSTAT=X88, which means Active andVaulted). 


A single status bit can' be set in1 a specific status byte of a 
volume/dataset record,. 


For example, 1;o tuz:n, on status PVLT (Potential. Vault) on' a 
volume record, include the following statement: 


VOLUPD ••••• , VOLZND=+PVLT 


To.turn. 1offthe·above status bit, include the following: 


VOLUPD~ •••• , VOLZND=-PVLT 


Specific Field Recommendations 


LBLNUM 


Return Codes 


0 


4 


12 


16 


20 


24 


28 
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Last label number on the volume. This value cannot be less 
than the value ofi ACTIVEDS (number ofi active datasets on 
the volume). If not specified, LBLNUM defaults to the value 
of ACTIVEDS. 


Operation performed successfully 


Minor erroJJs occurred. Operation continues 


Load of other CONTROL-T programs failed 


Media Database I/O error 


Input Control' Statement error 


Authorization failure (by security exit) 


Invalid return' code from routine CTTEXP 
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Example 1 


Convert scratch volume DIDD020 to active status and: add dataset FILE7 to the volume. 


I I 
EXEC 
C'l"l'MOP, 
llSYSr.N 
DD * 


'l'YPERUN 
MODE=NORMAL 
VOLUPD 
VOLSER=DDD0201, ACTr.vEDS=1, VOLSTAT=ACTJ:VE 
DSNADD 
DSVOLSER=DDD02 0 1, DSLABEL=1, DSNAME=Fr.LE7, 
CRED'J:l=950622, CRETM=142S001, CRE.:JBN=JOB1 


Example 2 


Rebuild a chain of: two volumes. The fi1lst volume, PRDOOl, has two datasets on it. The 
second dataset reached the end of: the first volume and continued on the second volume, 


PRD002. 


I I JOB NAME 
JOB. • ••• 
llCTTMUP 
EXEC C'l"l'MOP 
llSYSIN 
DD * 


II 


'l'YPERUN 
MODE=NORMAL,RtmEr.NFO=YES.,CHECK=NO 
VOLUPD 
VOLSER=PRD00ll.,VOLSTAT=ACTJ:VE,VOLSEQ=1,ACTJ:VEDS=2,LBLNtJM=2, 


VOLOPD 


DSNADD 


DSNADD 


MEDIA=3 4 8 0 ,, LOCATr.ON=MAr.NL:CB, Fr.RSTVOL=PRDO 01, 
NEXTVOL=PRD002,PREVVOL= 
VOLSER=PRD002,VOLSTAT=ACTr.vE,VOLSEQ=2,ACTr.vEDS=1,LBLNtlM=2, 
MEDIA=34801LOCATION=MAr.NL:CB1Fr.RSTVOL=PRD001, 
NEXTVOL=,PREVVOL=PRDOOll. 
DSVOLSER=PRDOO!I., DSLABEL=1, DSNAME=PROD" BACKUP. GOO 0 ll. VO 0 ., 
VOLSNUM=1 
DSVOLSER=PRD00ll.,DSLABEL=2,DSNAME=PROD.BACKOP.G0002VOO, 
VOLSNUM=2 


Considerations 


• This example assumes that PRDOOl and PRD002 we defined in1 the Medfa Database and 


we in SCRATCH status. If these volumes we not defined in, the· Media Database,, you must 
change the first two control cwds fromiVOl!..UPD to VOLADD. 


• Parameter ACTIVEDS is set to 2 fo11 PRDOOl because PRD002 contains the two datasets. 


PRD002' contains only the second dataset, so ACTIVEDS ·is set to 1 for PRD002: 


• LBLNUM is set to. 2 ·for both volumes because the highest label number on both of volumes 
is label 
12:. 


• The second dataset, PROD.BACKUP.G0002VOO has VOLSNUM=2 because it spans the two 
volumes. 


• RULEINFO= YES indicates that retention and vaulting attributes we automatically taken 


fromi the rules. It is therefore unnecessary to, specify retention and vaulting information. 
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CTTRCV - Recover the Media Database Using Trace File 


Utility CTTRCV recovers damaged Media Database (MDB) contents acco11ding to trace 
data reco11ded during Media Database update operations. The utility can pel1formi either a 
physical 011 a logical recovery. 


• Physical' Recovery (Roll Forward) 


Physical recovery assumes that the last available backed-up Media Database was resto11ed 
to disk (see utility CTTTRB in this section~. Fromi this· point forwa11d, the recovery is 


performed according to·trace data. 


Trace reco11ds are read starting with the fi11st reco11d after the Media Database backup 
recol1d. The recovery continues until the last trace recol1d is reached. When the process is 


finishedi the Media Database will have been brought back to the condition it was in' befo:r~e it 
was damaged. 


In situations where no Media Database backup has been performed, the recovery may be 


starled from the first trace reco11d. 


While the physical recovery process is running, the CONTROL-T Environment should be 
inactive (011 unpredictable results may occur). 


• Logical Recovery (RoU Back) 


Logical recovery rolls back selected changes from the current Media Database .. This type of 
recovery can be performed when a user modifies the status of one or more Media Database 
records, and subsequently discovers that these modifications should be reversed. A good 
example of this scenario is the run of a job which scratches a series of active volumes or 
moves a series of volumes to a vault incorrectly. 


When this type of recovery is used, the trace reco11ds are read, backward (starting from the 
last record towards the first reco11d). The improper modifications are reversed in: a way that 
resto11es the Media Database to the condition it was in: prior· to the improper modifications. 


To· maintain the logical' consistency of the Media Database, the utility must verify that the 
current contents of the Media Database match the information' in the Trace file. Therefore, 
before a Media Database operation' is reversed, the utility checks that the· current Media 
Database reflects that operation. For example, if the status of a volume was changed from 
Active to• Scratch by TSO user ABC, and a logical 
1 recovery is performed on all operations 
performed by user ABC, the utility verifies that the cU11rent volume status in the Media 
Database is Scratch, before the recovery reverses the operation' The check can, be bypassed 
(by specifying FORCE= YES) but this may lead to unpredictable results. 


Activating the Utility 
II EXEC 


llSYS'X.N 


CTTRCV 


DD * 


II 


RECOVER TYPE=PHYS'X.CALILOG'X.CAL [MODE=S'X.MULAT'X.ONINORMAL] 


[,FROMREC=LASTBKPIF'X.RSTREC][,CHECRACT=YESINO] [,RECAT=YESINO] 


[I FORCE=YES I NO] 


<'X.NCLUDE/EXCLUDE STATEMENTS> 
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Parameters 


Utility parameters are supplied via DD statement SYSIN: 


RECOVER 
Determines the type 0£ recovery that should be perfo:vmed. 


TYPE 


MODE 


Type of the recovery. Mandatory. 


PHYSICAL 


LOGICAL 


A physical (rolli fo:nward) recovery is to 
be perfo:vmed, 


A logical (roll back) recovery is to be 


perfo:vmed: 


Mode 0£ recovery. Optional. 


SIMULATION 
Simulation mode. Trace records and 


Media Database records when' needed) 


ave read, but the Media Database is not 
updated 
and 
datasets 
ave 
not 
recataloged. 


NORMAL 
Normal mode .. This is the default. Trace 
records and Media Database reco11ds 


(when, needed) are read, and' updates 
are actually performed on the Media 
Database (i.e., the Media Database is 
(_) 
updated). 


FROMREC 
Starting point of the recovery. Can only (and must) be specified when 


TYPE=PHYSICAL. 


LASTBKP 
The recovery stavts from the point where the Media 
Database was last backed up: 


FIRSTREC 
The recovery stavts from the first Trace 


reco11d. This option is useful for new 
sites which have not yet performed any 


Media Database backups. 
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CHECKACT 
Check whether or not CONTROL-T is active before 


staJ.1ting the recovery. When recovery is performed, the 


CONTROL-T Real~time Environment should not be active 
(i.e., it should be down or suspended). In simulation mode, 
this parameter has no·effect. 


RECAT 


FORCE 


YES 


NO 


If, before starting the recovery, 


CONTROL-Tis active, recovery will: not 
be started. 


Recovery will' be started whether or not 


CONTROL-Tis active. 


Note 
Specifying 
NO 
can 
cause 


unpredictab'le results· and the 
loss of Media Database integrity, 


if CONTROL-Tis actiue. 


This value is useful to initiate a recovery in a test 
environment on a test Media Database while the 
production environment is still! active. 


In logical' (roll! back) recovery, indicates whether datasets 
that were uncataloged by utility CTTRTM should be 
recataloged. 


YES 


NO 


Recatalog all datasets that were 
uncataloged. 


Note 
The same catalog environment 
that existed for CTTRTM is 
required by· CTTRCV. 


Do 
1not recatalog datasets. 


Jn, logical1 (roll back) recovery, indicates whether a check will 
be performed to verify that the current contents of the Media 
Database match the operation that should be reversed. 


YES 


NO 


Perform the operation reversal without 


performing the check. 


Note 
Specifying 
YES 
can 
cause 


unpredictab'le results· and the 
loss of Media Database integrity. 


Perfo11mi the operation reversal only if 


all: checks were performed successfully. 


The scope of the utility can be limited by one or more INCLUDE or 


EXCLUDE 
statements. 
INCLUDE/EXCLUDE 
statements 
are 
optional, and are valid only when a logical (roll back) recovery is 
performed (i.e., TYPE=LOGICAL). 
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For more information about INCLUDE/ EXCLUDE statements for this 
utility, refer to "Logical Field Names for the CONTROL-T Repository" 


in Appendix D. 


For additional information' on INCLUDE and EXCLUDE statements, 
see "Record, Selection Logic (INCLUDE/EXCLUDE Statements)" 


earlier in this section. 


Return Codes 


0 
Recovery operation performed' successtully 


Input statement(s) missing 
4 
8 
12 
16 
24 
28 
32 


Example! 


DC:B open, error occurred 


Input statement parsing error or validation error occurred 


CONTROL-T Control1 Table (TCT) load failed 
Media Database/Trace file 1/0 error occurred 
Logical error in Media Database (for TYPE=LOGICAL) 
CONTROL-T Reali-time Environment is active 


Recover a damaged Media Database. The last available Media Database backup has been 
restored, to· disk. 


//EXEC 


//SYS'I.N 


Example2 


C'l'TRCV 


DD * 


RECOVER'l'YPE=PHYS'I.CAL,FROMREC=LASTBKP 


Reverse aU changes performed by user M27A from July 19th, 13.40.00, to July 22nd, 
12.24.45z 


II EXEC 


//SYS'I.N 


C'l"rRCV 


DD * 


RECOVER 'l'YPE=LOG'I.CAL,RECAT=YES 


'I.NCLTJDE USER'I.D=M27A,DATE=950719,T'I.ME>134000 


INCLUDE USER'I.D=M27A,DATE>950719 


EXCLUDE DATE>950721 


INCLUDE USER'I.D=M27A,DATE=950722,TIME<122445 
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CTTRPT • Database Extraction and Report Utility 


Utility CTTRPT extracts data from the Media Database (MDB) via Extract parameters, 
and generates reports from the extracted data via Repo11t Formatting parameters. 


The utility can be used in either 0£ two ways. 


• Data extraction and report generation, we performed in a single utility run. Both Extraction 


pwameters and Report Formatting pwameters are specified in the utility run. 


Instead of extracting entire records, the utility only extracts information required for the 
report from the Media Database (or from the extracted dataset described above), and 
produces the report. There is no need to create a dataset fol' saving the extracted 
information, although this can be done if desmed. 


This method of report generation is the most efficient when: a single report is required. 


It is also· most efficient when1 all! the data requmements 0£ subsequent reports can: be satisfied 


from the extracted data (i.e., when no additional, data is requmed by subsequent reports). In 
this case, the extracted data should be saved in a dataset for subsequent runs of the utility. 


• Data extraction and report generation are performed in separate utility runs. 


One run of the utility uses Extract pwameters to select and extract entire volume andloll 


dataset reco:vds from: the Media Database which the utility saves in a dataset. 


Subsequent runs of the utility can, then: use Report Formatting parameters (REPORT, 
FIELDS and SORTBY statements) to generate reports in different formats from: the 
extracted dataset. 


This method is most efficient when: different reports use the same reco11ds but require data 


&om: different fields. 


At least one group of parameters (i.e., Extract parameters, or Repo:r:t Fo11matting 


parameters) must be specified. 


The dataset for holding extracted info:vmation is specified in DB statement REPDATA. 


Primary Key, Primary Fields and Primary Lines in Report Generation 


The user can: define up to two lines which comp11ise the report output (i.e., the user 
determines which fields are included in, the report lines). 


Many fields in a repo11t maintain the same value foll man:y records (e.g., vault name foll a 
multi-volume group). These fields are called pllimary fields, and one of them is the primary 
key. (The field which is the pvimary key and the fields which are the p11imary fields are 
determined: by the type of report being generated.) 


Via parameter ID=P I S, the user can: designate a repollt line as a pl'ima11y line. Primary 
lines are only printed when, the p11imary key changes value. 


The primary key and the primary fields are determined as foUows: 


• In the GENERAL report, the primary key is determined according to· PATH parameter 
specified in EXTRACT statement. 


If PATH=VOLUME/ALLDATASETS or PATH=VOLUME/FIRSTDATASET is specified, the 
primary key is the volser and the primary fields are the fields extracted from volume reco:vd. 
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If PATH=DATASET/ALLVOLUMES or PATH=DATASET/FIRSTVOLUME is specified,. the 
primary key is the dataset's volser and dataset's sequence number; and p:cimary fields are 
the fields extracted from the· dataset record~ 


• ln1the DISTRIB report, the p:cimary key is the volume's volser (or the first volume's volser in 
a multi-volume chain) and the p:cimary fields are the fields common fo11 all! volumes in the 
chain (e;g., FromLocation1 and To 1 Location~, and the fields extracted from the dataset record 
which determined the vaulting pattern. 


• In1the SCRATCH report, the primary key is the volume's volser (or the fust volume's volser in 
a multi-volume chain) and the primary fields extracted from the expiration dataset reco11d. 


Activating the Utility 
II 
EXEC CTTRPT 


l/IfEPDATA 
DD DSN=extract-dataset 


llSYS'X.N 
DD * 


<EXTRACT parameters> 


<IfEPORT parameters> 


Parameters 


Utility parameters a11e supplied via DD statement SYSIN: 


Extract Parameters 


EXTRACT PATH=VOLUMEI 


VOLUME/F'X.RSTDATASETI 


VOLUMEIALLDATASETSI 


DATASET!· 


DATASETIF'X.RSTVOLUMEI 


DATASETIALLVOLUMES 


<'X.NCLUDEIEXCLUDE statements> 


EXTRACT PATH=rectype 
Specifies the type ofreco11ds to.be·extracted. Valid values are: 


VOLUME 


VOLUME/ 


FIRSTDATASET 


VOLUME/ 


ALLDATASETS 


DATASET 


DATASET/ 
FIRSTVOLUME 


DATASET/ 


ALLVOl'..UMES 
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Volume records are extracted~ 


Volume reco11ds with only thei11 first dataset 
records 
we 
extracted. 
Abbreviation: 


VOLUME/FIRSTDS 


Volume records with all' their dataset records are 
extracted. Abbreviatiorn VOLUME/ALLDS 


Dataset records we extracted. 


Dataset reco11ds with only their first volume 


reco11ds· 
we 
extracted. 
Abbreviatiorn 


DATASET/FIRSTVOL 


Dataset records withallitheir volume records are 


extracted. Abbreviation: DATASET/ALLVOLS 
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Multiple EXTRACT statements can be specified in DD statement SYSIN, but each 
additional EXTRACT statement must follow the INCLUDE/EXCLUDE statements (if any) 


and the Repo11t Pa11ameter statements of the preceding EXTRACT statement. When saving 
extracted data in a dataset, if several EXTRACT statements are specified, only the data 
extracted by the last EXTRACT statement is stoved. 


INCLUDE/EXCLUDE Statements 


The scope of extraction can be limited by one o:ri mo11e INCLUDE 011 EXCLUDE statements. 


INCLUDE/EXCLUDE statements can be specified only immediately after the EXTRACT 
statement. 


Subparameters specified in INCLUDE/EXCLUDE statements must not contradict the 
PATH parameter of the EXTRACT statement. 


For example, if PATH=DATASET is specified, subparameters specified in the 


INCLUDE/EXCLUDE statements must not include fields from volume recovds. 


The subparameters which can' be specified in INCLUDE/EXCLUDE statements are listed 
in Tables 1 and 2 in Appendix: D of this manual. Rt!fer to this appendix fo:ri more 
information. 


For additional info11mation concerning INCLUDE/EXCLUDE statements, see "Record 
Selection Logic (INCLUDE/EXCLUDE Statements)" earlier in this section, 


Report Formatting Parameters 


REPORT NAME=GENERAL,TITLE='text•, 


PAGES7ZE=p,LZNES7ZE=s,MARG7NS=m-n,SUMMARY=YESjNO,OUTDD=ddname 


FIELDS field 1/options-1,field 2/options-2, ••• ,field n/options-n,ID=PIS 


SORTBY field 1/options-1,field 2/options-2, ••• ,field n/options-n 


ATTR 
F7ELD=f,LENGTH=t,TITLE= 1 text 1 ,EDZT='mask 1 


BREAK 
F7ELD=f,COLUMN=c,SUMTZTLE= 1 text 1 ,EDZT= 1numeric mask• 


REPORT 
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Activates report fovmatting. The following subparameters can be specified: 


NAME 


TITLE 


PAGESIZE 


LINESIZE 


Report name. Mandatory. Valid value is: 


GENERAL 
General report of information, extracted 


from the Media Database. 


Report title. Optional, The maximum length of text is 64 
characters. Default: 'General Report' 


Maximum lines in' a page, where p is a numeric value 
greater than, 20. Optional1 Default: 63. 


Maximum chavacters in a line, where s is a numeric value 
not greater than 255. Optional1 Default: 127. 


MARGINS=m~n Lowest (m) and highest (n) columns in a line, where m is a 
numeric value less than s (the value of LINESIZE), and n, 


is a numeric value greater than m but not greater than s. 
Optional. Defaults: m=l and n=s. 
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Indicates whether or not to show a summary line for each 
fieldbreak. Optional1 Default: NO. 


A field' break occurs when there is a change in value for a 
field which is specified in a SORTBY statement with 
option /BRK. 


JQL DJJ> name of the output. Default: REPOBT. 


Output fields (i.e., fields required in the report), and the options that 
can be applied to each field. Mandatory. 


The GENERAL report can contain, volume and, dataset fields which 
can be specified' as INCLUDE/EXCLUDE subparameters and special 
fields 
which 
cannot 
be 
specified 
as 
INCLUDE/EXCLUDE 


subparameters (described with their attributes later in this utility). 


Options 


ID=PIS 


Options can be added as a suffix to any output field in the 


list (optional: for each field). The slash (/) preceding the 
option is required to distinguish the option from the field~ 


Any number of options can be added to an output field. 
Available options we: 


/Ln 
Length 0£ the output field. n must be a numeric 
value which does not exceed the length defined in, 
the list of available fields. This option should' be 
used for Alphanumeric and Hexadecimal fields 
only. Optional. 


This value, if specified, overrides a LENGTH value 
specified in the ATTR. 


/Qn 
Column in which the field should' begin in the 
printed output. If specified for a field, it must be 
specified for all preceding fields. n, must be a 
numeric value greater than the last column of the 
preceding field (i.e., determined by the preceding 
field's beginning column and field length). 


Output line indicator. This parameter designates an 
output line as a Primacy Line (P) or Secondacy Line (S)., 
These values determine whether or not duplicate lines are 
printed from Volume and Dataset data. 


P 
Primary line indicator. The primary fields in the 
line are only printed, once, and' printed again only 


when: the primary key changes value. 


S 
Secondary line indicator. The line is printed for 
each record. 


If this paxameter is not specified, a line is printed for 
every input record. 
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Sort 011der ofthe output fields (see FIELDS above). Optional. 


Options 
Options can be added as a suffix to any output field in the 
list (optional: fo11 each field). The slash ({) preceding the 
option is reqilWed to distinguish the option' from: the field. 
Any number of options can 
1 be added to. an, output field. 
Available options ar:e: 


/BRK011/B 


/ASC 


/DSC 


/RSR 


/RSF 


Insert a page break in the report when 
the field changes its value. If specified for 
a field, it must be specified for all 
preceding fields. 


Sort the field in ascending o:rider. Default. 


Sort the field in descending order. 


Reset the row number whenever the field 
changes values. This option is effective 
only when field ROWID is specified in 
the FIELDS statement. 


Reset the page number whenever the 
field changes values. This option also 
automatically activates option /RSR. 


Note 
Primary fields appearing in a SORTBY statement should appear 
before non-primary fields. 


Examples of SORTBY usage ar:e ·provided below. 


Example 1 


Example2 


SORTBY LOCATION 


/BRK,POOUBRK/DSC,MEDIA/ASC 


Output is sorted by vault (LOCATION) in ascending 
order (the default), by pool (POOL) within a vault in 
descending 011der, and by media (MEDIA) within a pool 
in ascending order. A page break is inserted each time 
the vault or pool changes. 


SORTBY LOCATION 
/BRK/RSF,MEDIA/BRK/RSR,EXPDT/DSC 


Output is sorted by vault (LOCATION) in 
1 ascending order 
(the default), by media (MEDIA) within a vault in 
ascending 011der (by default), and by expiration date 


(EXPDT) within a media in descending 011der. A page 
break is inserted for every change in vault and media, and 
the page number (and, by default, the row number) is 
reset each time the vault changes. The row number is 
reset each time the media changes. 
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Overrides default attributes defined for a field. OptionaL 


At least one optional parameter must be specified for statement ATTR. 


An ATTR statement can: be specified for any field, even' a field not included 
in' a FIELD statement. The report, however, is not affected by an ATTR for 
a field until the field is included in a FIELD statement. (This means that an 
ATTR statement can' be defined in advance for each fieldi as desired, and be 
ready for use when the field' appears in: a FIELD statement.) 


Member ATTRGEN in the CONTROL-T PARM library contain sample 
ATTR statements for the GENERAL report. 


The following parameters apply to the field whose attributes should 
be changed: 


FIELD=name Name·of the field. Mandatory. 


TITLE='text' 
Field header. 'text' is any character string (enclosed in 
apostrophes) .. To split the header between lfues, insert a 
slash(/) before each line break. The number of header lfues in 
the report is determined by the field whose TITLE parameter 
text has the highest number o£1ines. Optional 


For example, iHhe following is specified: 


ATTR 
FIELD= VOL.SER 


TITLE="V olume/Serial/Number" 


The header for field VOLSER willl span, tlrnee output lines 
as follows: 


Volume 


Serial 


NUmber 


LENGTH:=t 
Length of the output field~ t must be a numeric value which 
must not exceed the field length specified in the list of 
available fields. Optional' An' /I'.,n· value, if specified for the 
same field in: the FIELDS statement, overrides this value. 


EDIT='mask' 
Field format, as specified through, a mask. The mask must 
be enclosed in apostrophes. Parameter EDIT cannot be 
specified for character and hexadecimal1 fields. Valid mask 
formats are: 
Numeric Format 


For numeric fields only. The mask can consist 0£ Z's and 9's 
and' commas, where 9 represents any digit, Z represents a 
digit which is suppressed if its value is a leading zero, and 
comma is a separator between' digits. 


When specifying a numeric format, the following rules apply: 


• A 9 cannot precede a Z in1 the mask. 


(_} 
• A comma cannot be the fust or last character of the mask. 
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Example 


Assume number 1234 is being edited (and bindicates blank) 


Mask SQecified 
Result 


'ZZ,ZZ9' 
bl,234 


'Z,999' 
1,234 


'999999' 
001234 


'ZZZ,ZZZ' 
bbl,234 


Date Format 


For Date fields. Valid mask combinations can have no,more 
than one day symbol~ one month symbol> and one year 
symbol. 


Valid symbols are: 


DD 


MM 


MMM. 


Day (i.e., values 1 - 31). 


Month (i.e., values 1- 12). 


Month (i.e.,.values Jun· - Dec). 


YYYear (last two digits, i.e., 00- 99). 


yyyy 
4-digit year (e;g., 1995). 


Symbols can, be optionally sepwated by one or more 


sepwation,chwacters: 'f, '.','-',blank, etc. 


Example 


Assume the date being formattedis August 23, 1994 


Mask SQecified 


'DDIMMIYY' 


'YYYY.MM.DID' 


'MM-DD-YYYY' 


'DD MMM YYYY' 


'MMM- DD - YYYY' 


'YY/MM~ 


Boolean Format 


Result 


23/08/94 


1994.08.23' 


os-23:..1994 


23Aug 1994 


Aug - 23 - 1994 


94108 


For Boolean fields (i.e., fields that contain1 a True/False or 


Yes/No condition). The specified FIELD is checked for a 
true/false condition in the record~ 
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The mask can contain either one value, or two values 


sepwated by a slash(/). A null value can1 be specified on 
either side of the slash. 


When 
1 one mask value is specified, the value is printed in 
the report only if the FIELD checks "true" in the reco:rd. (If 
the FIELD checks "false", the mask value is not printed; 


blanks are printed instead,) 


When two values are specified, the first value is printed in 
the report if the FIELD checks "true" in the record. The 
second value is printed if the record checks "false". 


Examples 


(1) ATTR FIELD=SCRATCH, 


TITLE='Scratch',EDirl'='Yes/No' 


(2) ATTR FIELD=ACTIVE, 
TITLE='Type' ,EDIT='Active/Scratch~ 


(3) ATTRFIELD=VAULTED, TITLE='V',EDirr='v' 


(4) ATTR FIELD=EDM, TITLE='Edm',EDIT='/No' 


The following ta~le shows the results of Boolean' editing for 
these examples. 


(1) 
SCRATCH 
Yes 
Scratch 


(2) 
ACTIVE 
Active 
Scratch 
Type 


(3) 
VAUI!.TED 
. v 
(blank) 
v 


(4) 
EDM 
(blank) 
Edm 


Attributes 0£ the summary line printed at the bottom of the page when 


a field break occurs .. Optional. 


For each field break, the user can specify a header and variables 
which indicate the number 0£ primary and secondal'y lines printed, 


and the value of the field. before·the break occm~red. 


At least one optional parameter of the· BREAK statement must be 
specified. 


A BREAK statement can be specified' for any field, even a field that is 
not included in a SORTBY statement .. The repo11t, however, is not 
affected by a BREAK fo11 a field until the field is included in a 


SORTBY statement with option1 /BRK, and SUMMARY= YES has been 
specified in' the REPORT statement. 
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(This means that a BREAK statement can: be defined im advance for 
each field, as desired; and be ready for use when the field appears in a 


SORTBY statement and report summaries are included.) 


FIELD=f 
Name of the field, Mandatory. 


SUMTITLE= Summary text to be printed when the value of a field 
'text' 
changes. text can be any string of characters. It must be 
enclosed in, apostrophes and can contain one or more of the 
following variables: 


%FIELD 
Value of the field before the break occu:vred. 


%CO'C!JNTP 
Number of primary lines printed before the break occurred~ 


%COUNT 
Number of secondary lines printed before the break 


occurred~ 


The default value of SUMTITLE 'text' is: 


'TOTAL IN %FIELD IS %COUNT' 


Note· 
If parameter ID is not specified in the FIELDS statement or there 
is only one FIELDS statement, the value of %COWNT is equal to 
the value of%COUNTP. 


COI!,UMN=c 
Column of the output line in' which the summary title will 
begin printing. c must be numeric. Optional. The default is 
the report start mwgin 1 specified: in parameter MARGINS of 
the REPORT statement. 


EDIT= 
'numeric 
mask' 


Required numeric format of %COtJNT and %COUNTP 


variables. 
Optional~ The default is 'ZZ,ZZ9'. (See the 
Numeric format example fo:p pariameter EDirr in the ATTR 
statement above.) 


Example 


REPORT NAME=DISTRIB,SUMMARY= YES 
FIELDS ... 


SORTBY 


BREAK 


BREAK 


ATTR ... 


TOLOC/BRK/RSRIRSP, 
FROMLOC/BRK, 
TOSLOT,FROMSLOT, 
VOLSER 
FIELD=TOL.OC, 


SUMTITLE='Total Volumes 
Moved To %FIELD is 


%COBNT', EDIT='Z,ZZ9' 


FIELD=FROMLOC, 
SUMTITLE='Total Volumes 
Moved From %FIELD is 


%COUNT', EDI'l'='Z,ZZ9' 
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Special Fields 


The following table contains a list of derived fields that can be included in GENERAL 
report. These fields do not exist in the Media Database reco:rids, but theiri values arie 


derived, from eitheri volume or dataset records, as indicated, where: 


V 
Indicates the source is a volume record 


D 
Indicates the source is a dataset record 


ROWID is an internal field, and therefore no source is indicated. 


These fields cannot be subparameters 0:£ INCLUDE/EXCLUDE statements. 


ROWID 
·Numeric 
5 
Row (line) number. It can be specified 
for either Primary or Secondary lines 
but not for both. 


VOLSTAT 
v 
Cha11acter 
12 
Volume statuses as shown below the 
header STATUS in Screen TL For 
more 
information. 
refer 
to' the 
description. of Screen TI in Section 2 
of this manual• 


DSSTAT 
D 
Character 
12 
Dataset statuses as shown below the 
header STATUS in Screen TL For 
more 
information. 
refer 
to 
the 
description of Screen· TI in Section 2 
of this manual1 


VSTATX 
v 
Hexadecimal1 
8 
Volume statuses in Hexadecimal 


representation, 


DST A TX 
D 
Hexadecimal 
4 
Dataset statuses in Hexadecimal 
representation. 


POOL 
v 
Cha11acter 
15 
Pool name derived &om the volser of 
the volume record. 


DSPOOL 
D 
Character 
15 
Pool name derived from the volser of 
the dataset record; 
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Return Codes 


0 
Operation performed, successfully 


8 
Missing DB statement(s), or open erro11 occurred 


12 
Control card erro11 


16 
Operation code not found 


20 
Invalid operation code 


24 
Syntax error in FIELDS 011 SORTBY statement 


28 
Field name specified in FIELDS or SORTBY list is undefined 


32 
Same parameter specified more than once 


36 
Length of field name exceeds maximum 


40 
Invalid relation specified (must always be equal, sign) 


44 
RepomN.AJ.V[Eisundefined 


48 
/BRK not specified for the preceding field in, SORTBY list 


52 
FIELDS statement not specified 


56 
Total ofi aU field lengths requested in FIELDS statement exceeds the line size· 


60 
Continuation card expected but not received, 


64 
Invalid numeric value 


68 
Option in FIELDS or SORTBY statement already specified 


72 
ROWID specified in BREAK or SORTBY statement 


76 
EDIT parameter in ATTR statement is invalid for specified FIELDS 


80 
EDIT mask is not valid 


84 
Specified number not in' permitted range 


For example, end column of a MARGIN statement exceeds the LINESIZE, or a column in1 


a FIELDS statement is outside the report's margins 


88 
Column option, (/C) not specified in the preceding field 


92 
Specified, column in a FIELDS statement is less than, the sum of the previous field's 
column and length 


96 
Second EXTRACT statement did not come after reporl statements 


100 
Load of CONTROL-T programs failed 


104 Load.of POOL table failed 


108 
Insufficient memory 


200 
Fields in FIELDS 011 SORTBY statements do not fit the PATH parameter of the 
EXTRACT parameters 
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Sample Reports 


The reports listed below can be genevated via utility CTTRPT, and are located in the IOA 
SAMPLE libvary. 


Some of: these sample repovts contain question: marks (??) where customization, is 
necessary. Replace the question marks with the desired values and use the appropriate job 
to produce the report. 


Reports 


CTTRFSCR 


CTTRINV 


CTTRINVT 


CTTRSCRD 


CTTRDELV 


CTTRCLN 


CTTRRTNP 


CTTRLACV 


CTTRD0RE 


CTTRMOVW 


CTTRCHKI 


CTTRUTIL 


CTTRLAVJ 


CTTRWD0P 


CTTROBTL 


CTTRLRTV 


CTTRMlOV 


CTTRMACV 


CTTREDM 


CTTRRCLV 


Full~scratch1 report .. Lists alli volumes in, scratch status in the Media 
Database. 


Vault inventory report. Lists an vaulted volumes and datasets in a 
specified location1 


Comprehensive inventory report. Lists all volumes and datasets in the 
Media Database. 


Lists all volumes scratched on a specified date, and the datasets 
residing on, these volumes. 


Lists all volumes in DELETED status. 


Clean repovt. Lists volumes that need, to be cleaned (i.e., each volume that 
has more than a specified thveshold number o£permanent 1/0 errors). 


Lists all datasets (and' their volumes) accovding to expiration date 
type (e.g., CYCLE, or CATALOG). 


Lists all volumes accessed today. 


Lists all datasets created yesterday. 


Lists all volumes moved in the past week (i.e., within the last seven days). 


Lists all external volumes checked-in in the past month (i.e., within 
the last 30 days). 


Lists aU volumes that are under-utilized, (less than, 50 feet). 


Lists all volumes that were last accessed by a certain job since a 
specified date. 


Lists all datasets that were written in a certain system ( CPV) since a 
specified date. 


Lists all volumes in an out-location' (borrower volumes). 


Lists all volumes with high, retention 1 dates (e.g., after year 2000). 


Lists aU multi-volume datasets which span more than ten volumes. 


Lists the most active volumes (accessed more than ten, times since 
they became active). 


Lists all EDM volumes. 


Lists all RECALLed volumes. 
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CTTRVUPD 


CTTRDUPD 


CTTRM25D 


CTTRVBOX 


CTTRBXLC 


Lists all volumes that were manually updated by a specified user. 


Lists all datasets that were manually updated by a specified user. 


Lists all volumes containing more than 25 active datasets. 


Lists the volumes stored in a specified box. 


Lists all volumes which are stored in, boxes, according to location and 


BOXID. 


CTTRNRTR 
Lists all borrowed volumes which have not yet been returned. 


Jobs for Report Production 


The above reports are produced via the following jobs (which are located in the JCL 
library): 


REPFSCR 


REPINV 


REPSJOB 


Used to produce report CTTRFSCR (full-scratch repo:r:t). 


Used to p:r:oduce report CTTRINV (comp:r:ehensive inventory report). 


Used fo:v all other repo:r:ts. This job requires minor: customizations that 
it refers to the desired repo:r:t. 


Example: Extraction and Report Generation in a Single Utility Run 


Extract all datasets from location VAULT! and generate a report showing all VAULT! 


datasets and their volumes so:r:ted by their pool1 name (DSPOOL) which is derived from 
dataset volser. 


//EXTRACT EXEC CTTRPT 


//SYS:CN 
DD * 


EXTRACT PATH=DATASET/ALLVOLS· 
:tNCLUDE LOCAT:tON=VAULTl 
REPORT NAME=GENERAL, SUMMARY=YES1 MARG:CNS=l-080·, L:tNES:tZE=OSO 1 
T:tTLE='Datasets in Vault VAUL'il'l' 
F:tELDS ROW:tD,F:tRS'l'VOL, 
DSNAME,DSLABEL,CREJBN,CREDT,LRECL.RECFM, 
:tD=P 
F:tELDS VOLSER/C13,MOVEDATE,VOLSEQ,SLOTNTJM, 
:tD=S 
SORTBY DSPOOL/BRK/RSP,F'I.RS'l'VOL.DSLABEL,VOLSEQ,SLO'l'NUM 
BREAK F:tELD=DSPOOL,COLUMN=10>ED:CT='Z,ZZ9', 
SUMT:tTLE='%F:CELD Datasets inVAUiaT1: 
%COUNTP' 
A'l'TR F:tELD=ROW:CD,T:C'l'LE='Row/'I.d',ED:CT='ZZ,ZZ9' 


ATTR F'I.ELD=F:tRS'l'VOL,T:tTLE='First/Volume• 
A'l'TR F'I.ELD=DSNAME,T:rTLE='/Dataset Name',LENG'l'H=24 


A'l'TR F:CELD=DSLABEL.T:CTLE='DS/Seq. 
1 ,ED:CT= 1 ZZ9' 
A'l'TR F'I.ELD=CREJBN,T:CTLE='Create/Job' 
A'l'TR F'I.ELD=CREDT,T:CTLE='Create/Date',ED:CT='DD MMM YY' 


A'l'TR F'I.ELD=LRECL, T:CTLE= •Record/Length·' , ED:CT= • zz, ZZ9 • 
A'l'TR F'I.ELD=RECFM,T:CTLE='Record/Format' 
ATTR F:tELD=DSPOOL.T:rTLE='Pool../Name• 
ATTR F'I.ELD=VOLSER1T:rTLE= 1 /Volser' 
ATTR F'I.ELD=MOVEDATE,T:tTLE='Move/Date',ED:CT='DD MMM YYYY' 
ATTR F'I.ELD=VOLSEQ,T:CTLE= 1Vol/Seq. 
1 ,ED:C'l'= 1 Z9' 
ATTR F'I.ELD=SLOTNUM,T:CTLE= 1 Slot/No. 
1 ,ED:CT= 1 Z,ZZ9' 
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{ 
J 
...._,; 
A sample ofi the output report from the above example is illustrated below: 


NEW DIMENSION SOFTWARE, 
L'l'D. 
CONTROL-T REPORT 
(REL 5. 0'. 0) 


Datasets in Vault VAUL'l'l 


------------------------- 


Pool Name: 
POOL-NUMBER-1 


Row 
First 
Ds 
Create 
Create 
Recol:'d Recol:'d 


Id 
Volume Dataset Name 
Seq. 
Job 
Date 
Length Format 
Move 
Vol 
Slot 


Vols er 
Date 
Seq. 
No. 
------ ------------------------------------- ------------------ ------ ------ 
58 016475 FDRABR.VTS0006.C1004900 
27 ZCOBKUPD 16 Jun' 96 
0 u 


0!2517 
23 Jun 1996 
55 
74 


015692 
23 Jun 1996 
56 
163 


0!5646 
23 Jun 1996 
57 
162 


016024 
23 Jun 1996 
58 
177 


59 016475 FDRABR.VESAD1A.C1002800 
28 ZCOBKUPD 16 Jun 96 
0 u 


016024 
23 Jun 1996 
58 
177 


015722 
23 Jun. 1996 
59 
167 


016048 
23 Jun 1996 
60 
178 


012771 
23 Jun 1996 
61 
90 
G" 
60 016475 FDRABR.VVSAMOO.C1001300 
29 ZCOBKUPD 16 Jun 96 
0 u 


012771 
23 Jun 1996 
61 
90 
010096 
23 Jun· 1996 
62 
16 


018862 
23 Jun 1996 
63 
223 


018839 
23 Jun 1996 
64 
222 


012914 
23 Jun 1996 
65 
96 


016314 
23 Jun• 1996 
66 
190 
016296 
23 Jun 1996 
67 
187 


Ol6211 
23 Jun 1996 
68 
184 


61 0!6475 FDRABR.VSCLM02.C1003500 
30 ZCOBKUPD 16 Jun 96 
0 u 


0!6211 
23 Jun 1996 
68 
184 


0!620! 
23 Jun• 1996 
69 
183 


0!6127 
23 Jun• 1996 
70 
181 


0!6337 
23 Jun· 1996 
71 
193 


0!6322 
23 Jun 1996 
72 
192 


015072 
23 Jun 1996 
73 
148 


62 016475 FDRABR.VVSAM12.C1006800 
31 ZCOBKUPD 16 Jun 96 
0 u, 


015072 
23 Jun· 1996 
73 
148 


015062 
23 Jun• 1996 
74 
147 


011488 
23 Jun 1996 
75 
44 
011035 
23 Jun 1996 
76 
31 


010970 
23 Jun 1996 
77 
29 


Ol0967 
23 Jun 1996 
78 
28 
63 017244 CA.BKUPMSTR.G0502VOO 
1 CALDPBK 
31 Dec 92 
8,287 VB 


~; 
0!7244 
07 Jun· 1993 
1 
113 


013076 
017 Jun 1993 
2 
110 
018149 
017 Jun 1993 
3 
114 
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015278 
07 Jun 1993 
4 
112 


O!l.9308 
017 Jun 1993 
5 
115 


O!l.3099 
07 Jun 1993 
6 
111 
64 O!l.8042 TS63.CATALOG.VWGL507.BAC 
1 ZTSVSMB4 16 Jun 96 32,756 VBS 
018042 
23 Jun 1996 
l 
9 


018137 
23 Jun, 1996 
2 
10' 
013684 
23 Jun, 1996 
3 
7 


O!l.1951 
23 Jun 1996 
4 
5 


011932 
23 Jun, 1996 
5 
61 


NEW D:cMENS:CON SOFTWARE, 
LTD~ 
CONTROL-T :REPORT 
(REL 2.1.0) 


Datasets in vault VAULTl 


Pool Name: 
POOL-NUMBER-1 


Row 


:Cd 


First 
Ds 
Create 
Create 
Record Record 
Length Format 


Slot 


Volume Dataset Name 
Seq. 
Job 
Date 


Volser 


Move 
Date 


64 018042 TS63.CATALOG.VWGL507.BAC 


O!l.1257 
23 Jun 1996 


010885 
23 Jun. 1996 


010870 
23 Jun 1996 


017991 
23 Jun 1996 


017509 
23 Jun 1996 


O!l.4339 
23 Jun 1996 


015050 
23 Jun 1996 


015097 
23 Jun, 1996 


65 018228 TS63.CATALOG.VMVSCAT.BAC 


018228 
23 Jun 1996 


66 018288 TS63.CATALOG.VWGL83A.BAC 


018288 
23 Jun 1996 


018280 
23 Jun, 1996 


67 018358 TS63.CATALOG.VWGL514.BAC 


018358 
23 Jun 1996 


POOL-NUMBER-1 Datasets in VAULT1: 


Vol 


Seq. 
No. 


l ZTSVSMB4 16 Jun' 96 32,756 VBS 


6 
40 


7 
25 


8 
24 


9 
209 


10 
1 
203 


11 
136 


12 
145 


13 
149 


l ZTSVSMB1 16 Jun 96 32,756 VBS 


l 
11 


l ZTSVSMBA 16 Jun 96 32,756 VBS 


1 
13 


2 
12 


l ZTSVSMB3 16 Jun 96 32,756 VBS 


1 
14 


67 
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Examples: Extraction and Report Generation in Separate Runs 


Extract Example 


Extract all volumes located in VAULT!, which was created by job ZCOIBKUP in June 1996~ 


//EXTRACT EXEC C'l"l'RPT 


//SYSI:N 
DD * 


EXTRACT PATH=VOLOME/ALLDS 


I:NCLUDE LOCATI:ON=VAULTl,CREJBN=ZCOI:BKUP 


EXCLUDE CRED'l'<1996060tl. 


EXCLUDE CRED'l'>19960630 


Report Formatting Example 


//:CNVREP EXEC CTTRPT 


//SYSI:N 
DD * 


REPORT NAME=GENERAL,StJMMARY=YES,MARGI:NS=1-801L:CNESI:ZE=801 
T:CTLE='I:nvento:ry Report• 


FIELDS ROWJ:D,VOLSER1VOLSTAT,MOVEDA'l'E,VOLSEQ,SLO'l'NUM,VOLEXPD'l', 
I:D=P 


FI:ELDS.DSNAME/C13,DSLABEL,CREJBN,CRED'l',BLOCKCT,DSEXPD'l', 


I:D=S 


SORTBY ACT:i:VE/BRK/RSP•POOL/BRK/RSP1 


LOCATI:ON/BRK/RSR1VOLSER,DSLABEL· 


BREAK 
FI:ELD=LOCATI:ON,EDI:T='ZZ9', 


StJM'l'I:TLE='Total number of volumes in·%FIELD: 
%COUNTP• 


BREAK 
FI:ELD=ACT:i:VE, EDI:T= I zz, ZZ9 I , 


StJM'l':CTLE='Number of %FI:ELD·Volumes: 
%COUN'l'P' 


BREAK 
FI:ELD=POOL,EDI'l'='ZZ9', 


StJM'l'I:TLE='Total number of volumes in %FIELD: 
%COUN'l'P(%COUN'l')' 


AT'l'R FI:ELD=ROWI:D, 'l'I:TLE= 'Row/Id·', EDJ:T=' zz, zz9·• 


AT'l'R FI:ELD=VOLSER,T:CTLE='/Vol.ser• 


AT'l'R FI:ELD=VOLSTAT,T:CTLE='Volume/Status• 


AT'l'R FI:ELD=MOVEDA'l'E,TI:TLE='Move/Date',ED:CT='DD MMM YYYY' 


AT'l'R FI:ELD=VOLSEQ,TI:TLE= 1Vol/Seq. 1 ,ED:CT='Z9' 


AT'l'R FI:ELD=SLO'l'NUM,T:C'l'LE=' Slot/No.' ,EDJ:T=' Z, ZZ9'' 


AT'l'R FJ:ELD=VOLEXPD'l',TJ:TLE= 1Volume/Expiration 1 ,EDJ:T='DD MMM YYYY' 


AT'l'R FI:ELD=DSNAME,TITLE='/Dataset Name',LENGTH=24 


AT'l'R FJ:ELD=DSLABEL,TJ:'l'LE= 1 Ds/Seq. 
1 ,EDJ:T='ZZ9 1 


ATTR FI:ELD=CREJBN,TI:TLE= 1Create/Job 1 


ATTR FJ:ELD=CRED'l',TJ:TLE= 1 Create/Date 1 ,ED:CT='DD MMM YY' 


ATTR FIELD=BLOCKCT,TI:TLE='Block/Count',ED:tT='ZZ,ZZ9' 


AT'l'R FI:ELD=DSEXPD'l',TI:'l'LE= 1 Dataset/Expiration 1 ,ED:CT= 1 YYYY-MMM-DD 1 


AT'l'R FI:ELD=ACT:i:VE,TI:TLE=''l'ype',EDJ:T='ACTJ:VE/SCRATCH' 


ATTR FJ:ELD=LOCAT:CON,TJ:TLE='Location• 


AT'l'R FI:ELD=POOL,T:CTLE='Pool/Name' 


I* 
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The following is a sample output produced by the above example. Note the following about 
the output: 


1. The page number, date, and time are not printed unless the LINESIZE specified ini the 


REPORT statement is at least 127. 


2. During printing, if there is insufficient room oni the current page fov secondary lines, the 
primary line is reprinted as part of the page header on the next page. 


3. A field specified with option1 /BRK in a SORTBY statement is shown in' the page header 
following the report title, and any slashes (/) specified in 1 the TITLE definition are 


supp:r~essed to· blanks. 


NEW. DJ:MENS:CON SOF'l'WARE, 
L'l'D. 
CONTROL-'!' REPOR'l' 
(REL 5. 0. 0) 


J:nventory Report 


'l'ype : 
ACTJ:VE 
Pool Name: 
POOL-NUMBER-1 


Row 


:Cd 


Volume 
Volser 
Status 


Dataset Name 


1 
010222 
vaulted 


FDRABR.VPROD02.C1005204 


FDRABR. VPROD01.C1008804 


FDRABR.VSAS001.C1006504 


FDRABR.V'l'S0006.C1004804 


FDRABR.V'l'S0003.C1015904 


2 
010372 
vaulted 


FDRABR. V'l'S0003 .C1015904 


FDRABR.V'l'S0002.C1015904 


3 
011938 
vaulted 


FDRABR. VWGLE00 
1.C10l35504 


FDRABR.VWGLE1C.C1027404 


FDRABR.VMV'S89C.C1005304 


FDRABR. VMV'S89D.C1005304 


FDRABR.VMV'SR1A.C1028204 


FDRABR. VWGL800 1.C1006704 


4 
011954 
vaua.ted 


FDRABR.VWGL514.C1041704 


FDRABR.VWGLE13.C1031304 


FDRABR.VMV'SRES.C1018704 
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Move 
Date 


Ds 


Seq. 


Create 
Job 


Jun 20-1996 


6 
ZCOJ:BKUP· 


5 
ZCOJ:BKUP 


4 
ZCO:CBKUP· 


3 
ZCOJ:BKUP 


2 
ZCO:CBKUP 


Jun 20-1996 


2 
ZCO:CBKUP 


l 
ZCOJ:BKUP· 


Jun 20-1996 


17 
ZCOJ:BKUP 


16 
ZCOJ;BKUP· 


15 
ZCO:CBKUP 


14 
ZCOJ:BKUP· 


13 
ZCOJ:BKUP· 


12 
ZCO:CBKUP 


Jun 20-1996 


20 
ZCOJ:BKUP 


19 
ZCOJ:BKUP 


18 
ZCOJ:BKUP 


Location: 
VAUL'l'l 


Vol 


Seq. 
Slot 


No. 


. Create 
Date 


Volume 
Expiration 
Block 
Dataset 


countl 
Expiration 


2 
427 
21 Jun 1996 


14 Jun 96 
0 
1996-Jun-21 


14 JUn 96 
0 
1996-JUn-21 


14 JUn 96 
Qi 
1996-Jun-21 


14 JUn 96 
0 
1996-JUn-21 


14 JUn 96 
999 
1996-Jun-21 


l 
433 
21 JUn 1996 


14 JUn 96 
999 
1996-JUn-21 


14 JUn 96 
999 
1996-Jun-21 


14 
487 
21 JUn 1996 


14 JUn 96 
0 
1996-JUn-21 


14 JUn 96 
O: 
1996-Jun-21 


14 JUn 96 
0 
1996-Jun-21 


14 JUn 96 
0 
1996-Jun-21 


14 Jun, 96 
0 
1996-Jun-21 


14 Jun1 96 
0 
1996-Jun-21 


15 
492 
21 Jun 1996 


14 Jun 96 
01 
1996-Jun-21 


14 Jun 96 
0 
1996-Jun-21 


14 Jun 96 
Q1 
1996-Jun-21 
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(0 
FDRABR. VWGLE001• C1035504 
17 
ZCOIBKUP 
14 Jun 96 
0 
1996-Jun-21 


5 
0120!1.6 
vaulted 
Jun 20-1996 
13 
506 
21 Jun 1996 


FDRABR. VWGL8001.C1006704 
12 
ZCOIBKUP 
14 Jun 96 
01 
1996-Jun-21 


FDRABR.VSCLM03.C1001304 
11 
ZCOIBKUP 
14 Jun 96 
0 
1996-Jun-21 


6 
O!l.2191 
vaulted 
Jun, 20-1996 
3 
529 
21 Jun 1996 


FDRABR.VPROD04.C10!l.6204 
7 
ZCO:IBKUP· 
14 Jun 96 
01 
1996-Jun-21 


FDRABR.VPROD02.C1005204 
6 
ZCO:CBKUP 
14 Jun 96 
0 
1996-Jun-21 


7 
012271 
vaulted 
Jun 20•1996 
9 
539 
21 Jun 1996 


FDRABR.VSCLM03.C1001304 
11 
ZCOIBKUP· 
14 Jun 96 
0 
1996-Jun-21 


8 
012313 
vaulted 
Jun, 20-1996 
12 
544 
21 Jun 1996 


FDRABR.VSCLM03.C1001304 
11 
ZCOIBKUP· 
14 Jun 96 
0 
1996-Jun-21 


9 
013315 
vaulted 
Jun 20•1996 
4 
551 
21 Jun 1996 


FDRABR.VPROD06.C1016204 
9 
ZCOIBKUP 
14 Jun 96 
01 
1996-Jun-21 


FDRABR.VPROD05.C1015904 
8 
ZCOIBKUP· 14 Jun 96 
01 
1996-Jun-21 


FDRABR. VPROD04 .C1016204 
7 
ZCO:CBKUP 
14 Jun 96 
01 
1996-Jun-21 


10 
014347 
Vaulted 
Jun, 20-1996 
11 
568 
21 Jun 1996 
u 
FDRABR.VSCLM03.C1001304 
11 
ZCOIBKUP· 14 Jun 96 
01 
1996-Jun-21 


11 
014743 
Vaulted 
Jun 20-1996 
10 1 
572 
21 Jun 1996 


FDRABR.VSCLM03.C100!l.304 
11 
ZCOIBKUP· 
14 Jun 96 
01 
1996-Jun-21 


12 
0!1.6465 
Vaulted 
Jun 20-1996 
5 
583 
21 Jun 1996 


FDRABR.VSCLM01.C1008904 
10 
ZCOIBKUP· 
14 Jun 96 
01 
1996-Jun-21 
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NEW D:CMENS:CON SOFTWARE, 
L'l'D. 
CONTROL-T REPORT 
(REL 5.0.0} 
.' 
\ 
v 


:Cnventoziy Report 


Type: 
ACT:cvE 
Pool Name: 
POOL-NOMBER"-1 
Location: 
VAULTl 


Row 
volume 
Move 
Vol 
Slot 
Volume 


Id 
Vols er 
Status 
Date 
Seq. 
No. 
Expiration 


Ds 
Create 
Create 
Block 
Dataset 
Dataset Name 
Seq. 
Job 
Date 
Count 
Expiration 
---------------------------- ----------------------------------------------- 
12 
016465 
vauil.ted 
JUn 20•1996 
5 
583 
21 JUn 1996 


FDRABR.VPROD06.C1016204 
9 
ZCOIBKUP 
14 JUn 96 
0 
1996-Jun-21 


13 
017248 
vauil.ted 
JUn, 20-1996 
6 
587 
21 JUn 1996 


FDRABR.VSCLM01.C1008904 
10 
ZCOIBKUP 
14 JUn 96 
0' 
1996-JUn-21 


14 
018377 
Vaul.ted 
JUn 20-1996 
8 
596 
21 JUn 1996 


FDRABR.VSCLM03.C1001304 
11 
ZCOIBKUP 
14 JUn 96 
0' 
1996-Jun-21 


FDRABR.VSCLM01.C1008904 
10, 
ZCOIBKUP 
14 JUn 96 
0' 
1996-.J'un-21 


15 
018393 
Vaul.ted 
JUn 20-1996 
7 
596 
21 JUn 1996 


FDRABR.VSCLM01.C1008904 
10 
ZCOIBKUP· 14 JUn, 96 
0' 
1996-JUn-21 


Total number of volumes in,VAUL'l'l 
15 
u 


POOL-NtJMBER"-1 Volumes: 
73 , 
POOL-NtJMBER"-1 Datasets: 
581 


Number of ACT:rvE 
Volumes: 
221 
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CTTRTM - Perform Retention Management 


This utility performs batch retentiom management functions. Batch retention management is 


performed daily to' check expiration: criteria and determine which datasets should be marked 
scratch. When all the datasets on: a volume have expired, the volume becomes a scratch 
volume .. The utility should be run as part o£the CONTROL-T New Day procedure (CTTDAY). 


Utility CTTRTM supports a number of different types of retention. See "Retention 
Management" in Section 4 of the CONTROL-T User Manual fo11 a list of the supported 
retention types. 


Utility CTTRTM does not perfo11m retention, management for the following volumes: 


• Vaulted volumes 


• Volumes not in the currently active library (i.e., volumes which have a status of Act-Out) 


• Volumes withiastatus o£Pend .. Vault 


• Volumes which have been recalled from: a vault 


• Volumes with a status o£Act-Use 


• Deleted volumes 


• EDM controlled volumes. 


Note 
Retention information for these volumes is updated by· utility· CTTRTM if either 


CONVERT or RECALC is specified for parameter TYPERET (described later). 
However, these volumes (and the datasets they contain) are not expired by the utility 


(i:e., they are not marked as scratched). 


Scratch Report 


Utility CTTRTM can produce a Scratch report at the end 0£ p11ocessing. The Scratch· report 
contains a list of all volumes which have expired (i.e., become scratch) as a result of this 
utility run. 


Note 
Full Scratch report FULLS CR is no longer generated by· utility· CTTRTM. Instead, this 
report can be generated as part of the GENERAL report by utility· CTTRPT. For more 
information see utility CTTRPT earlier in this section. 


Utility CTTRTM adds the following special pool 
1 names in: the POOLNAME field of certain 
volume records in the Scratch report: 


EXTERNAL 


EXT-DEI1 


EXT-Dl!JP 


External volumes not deleted from the Media Database 


External: volumes deleted from the· Media Database. 


External volumes which, are not deleted from the Media Database but 
whose SL-NAME and VOLSER are different. 


Dl!JPLICATE VOL 
Internal volumes whose Sll.-NAME and V0LSER are different. 


The special pool name is written over the p:1~evious name in field P00LNAME (i£ one existed). 
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Scratched volumes with different SL-NAMEs and VOLSERs (listed in, the EXT-DUP and 


DBPLICATE VOL pools) should each be re-initialized (via utility CTTTPI) to set the 
SL-NAME to the value ofithe VOLSER. 


Recovery From Abends 


Since utility CTTRTM updates the Media Database in several stages, a CANCEL 


operation~ job, abend 
1 or system crash can lead to logicalinconsistencies in the database. 


CONTROL-T can recover from abends occurring during the run of utility CTTRTM. The 
type of recovery depends on1 the stage ofi the utility in which the abend 1 occurred. Utility 


CTTRTM perfo11ms retention management in the following stages: 


L A physical file is produced which contains the information' necessary fo11 updating the 
relevant records in the Media Database. 


2: The Media Database records are updated. 


3. A Scratch report is produced. 
If an abend occurred during Step 1, no updates were performed. on, the Media Database, 
and the utility can be rerun normally. 
If an abend occurred while the Media Database was being updated (Step 2), the next time 
utility CTTRTM is run, it will automatically enter RESTART mode and continue updating 
the Media Database from where the previous run terminated .. (The utility uses the 
physical file created in Step 1, and a timestamp which indicates the point at which the 


p11evious run of utility CTTRTM was interrupted.) 
If an 1 abend occurred after all updates ofi the Media Database were performed but the 


Scratch report was not produced, this report can, be generated by rerunning the utility 
with the following parameters: 
· 


'l'YPERlJN 
REPORT 


F:CEI:.DS 


SORTBY 


Where: 


MODE=NO:RMAL 


NAME=SCRATCH 


fiel.ds 
fiel.ds 


fields 
Same fields that were specified in· the FIELDS and SORTBY 


statements in the original run of utility CTTRTM. 


Note 
No value should be specified for parameter TYPERET in this run ofutilityCTTRTM. 


Exits Used by Utility CTTRTM 


The following exits can be used to influence a run 0£ utility CTTRTM: 


CTTX006 


CTTX008 
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Receives 
control, immediately 
before 
updates 
are 
made 
to 
dataset/volume records in the Media Database. This exit can be used 
to accept or reject expiration ofi a dataset record, and/or to update a 
dataset/volume record before it is marked as scratched. 


Receives control when the Scratch repoilt is used to update the 
information in the robotic tape libDary (if one exists at your site). This 
exit can be used to scan the scratch report and to determine which 
volume recoI1ds are updated in the robot's database. 
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Relevant Installation Parameters 


Installation. parameters (specified in member CTTPARM) determine how utility CTTRTM 


operates. These parameters are described below. 


RTNTYPE 


CYCLECNT 


EXPDTYPE 


Specifies when the datasets on the volume will be scratched. 


VOL 


DSN 


Each dataset on: the volume will be m0.11ked scratch, only if 
all datasets on the volume have expired. This option is 
recommended for compatibility with CA-1 and CA-TLMS. 


Each dataset recordls expiration1 criteria in the Media 
Database is independent of other datasets on the volume. 


Note 
A multi~volume chain functions independently of 
parameter RTNTYPE.. Only if all datasets on 
each volume have expired will all the datasets of 
the chain be marked scratch and all volumes of 
the chain become scratch. 


Defines how to calculate cyclic datasets. Valid values are: 


DSl 


DS 


DSJ 


DSJl 


Handles datasets with the same dataset name and 
creation date as a single cycle. Default. 


Handles datasets with the same dataset name as sepaxate 


cycles. The creation1 date is ignored 


Handles datasets with the same dataset name and job 
name as a single cycle. The creation: date is ignored, 


Handles datasets with the same dataset name, creation 
date andjob name as a single cycle. 


Determines expiration logic depending on the type of retention 
criteria and value specified: 


• When DATE or DAYS retention criteria are assigned to a dataset: 


CAl 


TLMS 


NONE 


CA-1 expiration logic applies. DATE or DAYS specifies the 
day on which the dataset is expired. Default. 


CA-TLMS expiration logic applies. DATE or DAYS 


specifies the last day of retention. The dataset is expired 
the follbwing day. 


Expiration date in standard MVS fomnat. 


• When, cyclic retention criteria are specified: 


CAl 
CA-1 expiration logic applies. Only primary datasets 
(datasets with LABEL=l) are considered in' the expiration 


calculation. Default. 


Other 
All' cyclic datasets are considered regardless of label 
number. 
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CTLGWAIT 


MODE 


SMSINTR 


TESTRUL 


CTTRTM 


Defines the number of wait days before utility CTTRTM checks a 
catalog-controlled dataset (i.e., one for which DO RETENTION= 
MVS CATALOG is specified) .. In some cases, a dataset is created 
during a job step and cataloged at the end of a later job step .. If utility 
CTTRTM is executed after the dataset is created but before it is 


cataloged> the utility expires the dataset. Parameter CTLGWAIT 
causes utility CTTRTM to' wait a specified number 0£ days before 
checking if the dataset is cataloged. 


Determines whether or not to uncatalog the expired datasets in: the 


MVS Catalog, 


TEST 


PRO]j) or 
PHASE 


Datasets are not uncataloged~ 


Datasets are uncataloged if no Test rules match the expired 


datasets (see parameter TESTRUL below). 


Determines whether or not the CONTROL-T to DF/SMS interface is 
active. If this interface is active, and expii::ation dates are defined, by 


SMS managed classes, retention is dependent on expiration dates 
specified in SMS Management Classes. 


Determines whether orr not Test rules are used in1 the productioni 
envfronment (global MODE=PROI'.> 011 PHASED). If an expired dataset 
matches a Test rule, the dataset should not be uncataloged. 


YES 


NO 


Test rules are used. The utility loads and scans the 


CONTROL-T rules .. 


Test rules are not used .. The utility does not load and, scan 
the CONTROI:.-T rules. Default. 


For additional information: refer to "Retention and Vault Parameters" in the IOA 


Installation: Guide .. 


Activating the Utility 


I I 
EXEC 
C'l''l'R'l'M 


llSYSIN 
DD * 


'l'YPERUN 
MODE=NORMAL I SIMUIIA'l'J:ON I [, DA'l'E=date] [, 'l'RACE=YES I NO] 


[,DBGLEVEL=1eveL] [,RES'l'AR'l'=YESINO] [,LIS'l'=YESINOIF'ULL] 


'l'YPERE'l' 
MODE=REGUIIAR 1.RECALC I CAlCONV I CONVER'l' [, UNC'l'LG=YES I NO] 


II 


[, UPDVOL=YES I NO] 


<J:NCLODEIEXCLUDE statements> 


REPOR'l' NAME=SCRA'l'CH, ••• 


FIELDS 


SOR'l'BY 


A'l"l'R 


BREAK 
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Parameters 


Utility parameters are supplied via DD statement SYSIN: 


Note 
While the TYPERET and REPORT parameters are each optional, at least one of them 
must be specified~ 


TYPER UN 
Operation, type .. Mandatory. 


MOI>E 


DATE 


TRACE 


Operation mode; Mandatory. 


NORMAL 
Nornnal operation is performed .. The 
Media Database is updated as required 
by utility CTTRTM. 


SIMULATION 
Simulation is performed. No 
actual 
changes we made to·the Media Database. 


In this mode, CONTROl!rT keeps in 
memory a list of Media Database records 
that would have been updated if the 
utility ran in NORMAL mode. 


Notes 
When utility CTTRTM is run in SIMULATION 


mode, it requires a much larger region than 
required in NORMAL mode .. The actual region 
size necessary depends on the number of updated 
Media Database records (which this utility stores 
in memory). 


Utility· CTTRTM can be run in SIMULATION 


mode at the same time as a run of utility 
CTTRTM is run in NORMAL mode. However 
more than one run of utility CTTRTM in 


NORMAL mode is not permitted. 


Operation date in 6- or 8-character fornnat according to 
site standard. (For example, in, USA standard the date can 
be specifi.ed,mm/dd/yy or mm/dd/yyyy.) Optional. 


Specifies whether or not the Trace file will! be used during 


CTTRTM run, Optional' 


YES 


NO 


The Trace file will be used. Default. 


The Trace file will not be used. 


DBGLEVEL 
Debug level. A numeric value from 1 to 255 can be 
specified. 


Note 
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This parameter should only be used if requested 
by your JOA representative. 
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TYPERET 
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RESTART 


CTTRTM 


Specifies whether or not to enable Automatic Restart; mode 
when the utility is run after ani abend or cancellation of the 
previous run of the utility. Valid values are: 


YES 


NO 


Enable Automatic Restart mode. Default. 


Disable Automatic ·Restart mode. 


LIST 
Specifies whether or not specific diagnostic messages (i.e., 


CTT301I, CTT3021, CTT4931; and' CTT4941) willibe produced. 
The messages are sent to SYSPRINT. Valid values are: 


NO 


YES 


FULL 


None of the above mentioned messages are 


produced. 


Messages CTT3011, CTT3021, and CTT4931 
are produced. Default. 


AU 0£ the above mentioned diagnostic 
messages are produced. 


Retention management type .. Optional if pa:rameter REPORT is 
specified .. If TYPERET is not specified, retention' processing is not 
performed, but the report produced by the last run 0£ utility CTTRTM 


is regenerated. 


MODE 
Retention management mode. 


REGULAR 


CONVERT 


Retention 
management 
is 
performed 
according to· the retention criteria currently 
specified in dataset records in the Media 
Database. 


This parameter is used after conversion1 


from a different Tape Management System 
(e.g,, CA-TLMS). 


Expiration date information is extracted 


from1 
one 
of the 
following 
locations 
(depending 
on 
the 
specifications 
for 


CONTROL-T installation parameters): 


- CONTROb-T rules 


- JCL EXPDT parameters 


- SMS Management Classes 


- 
Default values defined m 
member 


CTTPARM 


The extracted retention information is used 
to update dataset records in, the Media 
Database. However, no actual expiration is 
performed. This enables the user to· check 
that the conversion works as planned, 
before 
retention 
management 
is 


implemented. 
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UNCTLG 


UPilVOL 


u 


IOA Ret 5.0.0 Administrator Guide 


Note 


Section 9: Utilities 


TYPERET=CONVERT should only· be specified 
in the following cases:. 


• 
This is the first run of utility CTTRTM since 
conversion 
from 
the 
previous 
Tape 
Management 
System, 
and 
retention 
information does not exist in the dataset 


records· created as· a result of this conversion 
(e.g., CA-TLMS). 


• 
Rules have been defined with new retention 
information that needs to be incorporated into 
the dataset records in the Media Database. 


RECALC 
Retention info:rnnation in dataset reco11ds in, 
the Media Database is updated, and 


expillation, is performed. Running utility 


CTTRTM 
with: 
TYPERET=RECALC 


specified has the same effect as running 
this 
utility 
twice; 
once 
with 


TYPERET=CONVERT specified, and a the 
second time with TYPERET=REGULAR 


specified, 


CAlCONV 
This. pwameter is used only after CA-1 
conversion' In, this mode, no retention 
actions a11e taken. This mode is used to· fill 
in the dataset name's prefix length (as 
defined in CONTROL-T rules) in the Media 


Database dataset records. This informationi 


is later used for retention management of 
cyclic datasets. 


Note 
If utility· CTTRTM has already· been run 
TYPERET=CONVERT 
specified, 
it 
is 
necessary 
to 
run 
it 
again 
TYPERET=CAJCONV specified. 


with 
not 
with 


Specifies whether or not to uncatalog datasets after 
scratching the dataset records :fuomi the Media Database. 
Optional. 


YES 


NO 


Uncatalog the datasets. Default. 


Do not uncatalog the datasets. 


Specifies whether or not to copy the retention infomnati,on 
from the dataset reco11ds to the volume where the datasets 
reside. (The highest retention period is stored in: the 
volume record.) Applies only if the MODE specified in the 
TYPERET statement is RECALC or CONVERT. Valid 


values are: 
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INCLUDE/ 
EXCLUDE 


YES 


NO 


CTTRTM 


Copy the retention, information to· the 
volume record, 


Do. not copy the retention information to the 
volume record. Default. 


Specifying NO can1 significantly improve 


performance time when running the utility 


ini CONVERT or RECALC mode. However, 
accurate retention information will! only be 
available via inquiry of dataset records in 
the Media Database (i.e., an1 inquiry of the 
volume records may not yield accurate 
retention, information). 


The scope of the utility can, be limited by one or move INCLUDE 011 
EXCLUDE statements. INCLUDE/EXCLUDE statements are specified 
immediately after the TYPERET parameter and are applied to 
retention processing. 


For additional information' on INCLUDE and EXCLUDE statements, 
see "Record Selection Logic (INCLUDE/EXCLUDE Statements)" 
earlier in this section. 


See also "Logical Field Names fo11 the CONTROL-T Repositovy" in 
AppendiiX D. 


Note 
As of CONTROL-T Release 2:1.0, INCLUDE/EXCLUDE 


statements cannot be specified after SQRTBY parameters. 


With few exceptions, the parameters and options of: the REPORT, FIELDS, SORTBY, 


ATTR and BREAK statements are identical' to those found in utility CTTRPT. For a 
complete description of: these parameters and options, refer to utility CTTRPT earlier in 
this section. Differences between the parameters and options of utility CTTRTM and 
utility CTTRPT are described below. 


FIELDS 
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Activates report utility. Optional: if a TYPERET pwameter is specified, 


NAME 


SCRATCH 


Report name. Mandatory. Validvalue is: 


Scratch report listing volumes which• expired based on, the 
execution, results of utility CTTRTM. 


Note 
Full scratch report FULLS CR is no· longer 
generated by utility CTTRTM. Instead, this 
report can be generated as part of the GENERAL 
report by· utility CTTRPT. A sample Full Scratch 


report can be found in member REPFSCR in the 


CONTROL-T JCL library. 


Fields to print in the repovt. The fields are printed in the order they 
are specified:. Available fields a11e: 


MEDI!A 


POOL 


Media type .. 


Pool1name. 
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SC>RTBY 


ATTR 


BREAK 


Return Codes 


0 


8 


12 


16 


20 


24 


28 


32 


36 


40 
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VOl.SER 
Volume serial number. 


SL-NAME 
Standaxd label name of the volume. 


UNAME 
Unit name. 


FIRSTVOl. 
First volser in a multi-volume group. 


DSNAME 
Name of the fust dataset in the volume. 


CREDS 
Creation date ofthe first dataset in 1the volume. 


EXPI:>S 
Expiration date of the first dataset in, the volume. 


EXPI:>T 
Expiration,date·ofthe volume. 


LACCDT 
Last access date of the volume. 


LOCATION 
Location'. 


CH:KINDT 
Check-in' date. 


IOERR 
Number of input/output errors. 


LCLNDT 
Last clean date .. 


VOLSTAT 
Status(es) of the volume .. 


Order in' which the report is sorted .. (Available fields are listed above 
under pa])ameter FIELDS.) The /B option can be added as a suffix to 
any field to. indicate that a page break should be inserted in' the report 
when the field changes its value. 


Override of default attributes defmed for a field. (see FIELDS above). 
Optional. 


Attributes of the summary header line(s) printed when a field break 
occurs. Optional. 


Operation performed successfully 


Missing DD statement(s), or open, error occurred 


Control' card error 


Load of CONTROL-T routines failed 


Sort error occurred, 


Media Database input/output error occurred 


Internal error occurred 


Error in repo11t p11inting utility occu11red 


Load of rule, pool, or vault table failed 


Authorizatfon erro11 (by security exit) 
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44 


48 


52 


Examples 


Media Database file in use 


Insufficient storage 


Logical error in Media Database 


CTTRTM 


In the following example, retention management is performed according to the current 
retention specifications in the Media Database. Report SCRATCH is printed, listing volser 
and media type, and is sorted acco11ding to pool 
1 name. The list fo11 each media type starts 
on a new page. 


II EXEC 
CT'l'R'l'M 


//SYSIN 
DD * 


II 


'l'YPERUN 
MODE=NORMAL 


'l'YPERE'l' 
MODE=REGtmAR 


REPORT 
NAME=SCRA'l'CH 


FIELDS 
POOL,VOLSER1MEDJ:A 


SORTBY 
POOL,MEDJ:AIB1VOLSER 


In the following example, retention information. is updated for all datasets whose name 
begins with prefix BKP. 


II EXEC 
CT'l'R'l'M 


llSYS'I.N 
DD * 


'l'YPERUN 
MODE=NORMAL · 


'l'YPERE'l' 
MODE=CONVERT 


lNCLUDE 
DSNAME=BKP* 


REPORT 
NAME=SCRATCH 


F'I.ELDS 
EXPD'l',MEDJ:A,VOLSER1POOL· 


SORTBY 
EXPD'l' 
II 


In the following example, the utility is used to produce the scratch report from the last 
finished run of utility CTTRTM. 
II EXEC 
CT'l'R'l'M 


llSYS'I.N 
DD· * 


'l'YPERUN 
MODE=NORMAL 


REPORT 
NAME= SCRATCH 


FIELDS 
fields 


SORTBY 
fields 


II 
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CTTSPL - Split the Media Database 


Utility CTTSPL extracts (i.e., moves or copies) Media Database records for transfer to a 
different Media Database. Before using this utility, it is important to review the 
information1 in1 "Split and, Merge Processing1'. 


Notes 
There is no need to 1shut down CONTROL-T while running this utility; 


Utility CTTMER (used to merge information extracted via utility CTTSPL) 


automatically· updates the Media Database index component. there is no need to run 
utility CTTBIX after the run of this utility. 


Split and Merge Processing 


The split and merge process is the method by which information' is extracted (split) fromi 


one Media Database and inserted 
1 (merged) into another Media Database (usually at a 
different site). This process is especially useful 1 when a decision is made to join two Media 
Databases, or to split a large Media Database in two or more smaller Media Databases. 


The split and merge process is performed via utilities CTTSPL and1 CTTMER. 


• Utility CTTSPL extracts records from the source Media Database according to specified 
selection criteria~ This utility can be usedwith either o£two functions. 


MOVE 
Moves selected records to 
1the extract file and deletes them fromithe source 
Media Database. 


COPY 
Copies selected 1records fromithe source Media Database to 1the extract file. The 
source Media Database is not altered when this function, is specified. 


The output of utility CTTSPL (the extract file) is a predefined sequential file 


(olpre:ft.olvert.REPDATA) allocated as one of the CONTROL-T operations libraries at time 
of CONTROl!..-T installation. 


• Utility CTTMER merges the extracted Media Database records into the Media Database in 
the target system1 Utility CTTMER uses the extract file created 
1 by CTTSPL as input. 
If utility CTTSPL is being used to move (not copy) Media Database records, the selected 
records are deleted from the source Media Database. 
If the target Media Database is in 1 a different site, the extract file (REPDATA) produced by 
utility CTTSPL must be transferred to the target site. 


Data Integrity 


Utilities CTTSPL and CTTMER do not check Media Database integrity. 


It is highly recommended that utility CTTIDB be used to check the source Media Database 
integrity before execution of utility CTTSPL. To avoid transfer of data errors to the target 
Media Database, integrity errors detected by utility CTTIDB should be fixed· in 
1 the source 
Media Database before execution, of utility CTTSPL. 


It is also recommended that utility CTTIDB be used after the split and merge process to 
check the integrity of the: 


• Sou11ce Media Database after running utility CTTSPL (if the MOVE function was specified). 


• Target Media Database after execution of utility CTTMER. 
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Simulation Mode 


Utilities CTTSPL and CTTMER can, be executed in simulation: mode. In this mode, no 
Media Database updates are performed .. Ini simulation mode, messages are sent to the 
utility log to record the updates that would be performed on the Media Database if the 
utility was running in regular mode. 


If the last run of the utility abended, simulation, mode is not allowed. If an attempt is 
made to run the utility in simulation mode, the utility is terminated and an approp:riiate 


message is displayed. 


A special restart simulation mode is available fov utility CTTMER. (See the description of 
the MODE parameter in the explanation of utility CTTMER fol' more information,) 


Note 
Since the Media Database is not updated in simulation mode, it is possible that a run 
of one of these utilities in simulation mode will end successfully, while the 
corresponding rU1n in normal mode could abend (e.g., due· to· a lack of free space in the 
Media Database). 


Volume Status 


Utilities CTTSPL and CTTMER do, not check volume status. Volume recol"ds are split and 
merged regardless of volume status. For some volumes (e.g., those with a status of 


VAULTED or PENDING-VAULT), this can result in inaccurate slot definitions. 


To correct this pvoblem,. it is necessary to. run utility CTTVTM in' SL.OTBLD mode to rebuild 
the SlOt Definition' Recol"ds. Utility CTTVTM should be run against both the source Media 
Database and the target Media Database after completion 0£ the split and merge pl"ocess. 


Recovery from Abends 


CONTROL-T can recover from abends occurring during the run' of utilities CTTSPL and 


CTTMER. If the utility has abended, during update of the Media Database (deletion of 
recovds in utility CTTSPL, or addition of recovds in utility CTTMER), when the utility is 
run again it will automatically enter RESTART mode and recover from the abend. 


The extract file (REPDATA) must not be altered (or deleted) priol" to restart execution of 
utility CTTSPI:.. or CTTMER. It is highly recommended that this file be backed up after 
each run of utility CTTSPI:.. to· facilitate recovery. 


Undoing Splits and Merges 


You can choose to, undo the actions of the Split/Merge utilities as follows: 


Splits 
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If utility CTTSPL was used with the MOVE function. Utility CTTMER 


should be used to merge the extracted recovds from1 the extract 
(REPDATA) file back into the source Media Database (specify the 
source Media Database as the target Media Database). 


Note 
If the extract file no longer exists but the extracted records have 
been merged into the target Media Database, they can be extracted 
(copied or moved) from the target Media Database into another 
extract file, and then merged back into the source Media Database. 


IOA Rel. 5.0.0 Administrator Guide 


u 


,. I 
·,. 
\_,;' 


CTTSPL 


Merges 


Section 9: Utilities 


If utility CTTSFL was used with the COPY function, the source Media 
Database is unchanged and there is no need to "undo" anything. 


To remove records that have been merged into· the target Media 
Database, use utility CTTSFL with the MOVE function to extract the 
necessary Media Database records from the target Media Database. 
The selection statements passed to the utility must include only the 
volumes added previously by utility CTTMER. 


Activating Utility CTTSPL 
II 
EXEC CTTSPL 
llSYS'LN 
DD * 


EXTRACT PATH=ALL 


<'LNCLUDEIEXCLUDE statements> 


I* 
llDA'LN 
DD * 


TYPERUN FUNCT'LON=COPYIMOVE[,MODE=NORMALIS'LMULATE][,DBGLEVEL=XXX] 
I* 


Parameters 


EXTRACT 


PATH=ALL 


INCLUDE/ 
EXCLUDE 


TYPER UN 


EXTRACT statement specified via DD statement SYSIN. This is the only 


EXTRACT statement allbwedwith utility CTTSPL. Mandatory. 


The scope of the utility can, be limited by one or mo11e INCLUDE and/011 
EXCLUDE statements. 


INCLUDE/EXCLUDE statements a11e specified immediately after the 


EXTRACT statement in the SYSIN DD statement. For mo11e information 
see "Record Selection Logic" earlier in this section, 


The TYPERUN statement is specified via DID statement DAIN. The 
format for this statement is: 


TYPERUN FUNCT'LON=COPY I MOVE [, MODE=NORMAL I SIMULATE] [, DBGLEVEL=XXX] 


Where: 


FUNCTION 
The function to be performed~ Mandatory. Valid values ane: 


COPY 


MOVE 


Records are to be copied (not deleted) 
from the source Media Database to the 
extract file (REPDATA). Copied records 
are not deleted from the sou11ce Media 
Database. 


Records are moved from the source 
Media Database to the extract file. 
Moved records ane deleted' from the 


sounce Media Database. 
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Operation mode. Optional' 


NORMAL 


SIMULATE 


Normal, operation, mode .. Default. 


Simulation mode. No changes are 
made 
to 
the 
Media 
Database. 
Messages are sent to the utility log to 
show which' changes would be made to 
the Media Database if the run was in 
NORMAL mode. 


Note 
The result of running utiliry CTTSPL in 
simulation mode is identical to running it with 


FUNCTION=COPY specified; The resulting extract 
file (REPDATA) can be used as input for a regular 
(or simulation mode) run of utility ·CTTMER. 


DBGLEVEL 
Debug level. A numeric value from 1 to 255 can be 


specified~ Optional. 


Note 


Example 1 


This parameter should be used only if requested 
by your JOA representative; 


In this example, utility CTTSPL extracts the records fo11 all volumes beginning with VOL. 


The reco11ds fo11 the volumes and their associated datasets are removed (deleted) from the 
source Media Database and placed in the extract file (REPDATA) to be used later as input 
for utility CTTMER. 


II 
EXEC 
CTTSPL 


//SYSIN 
DD * 


/* 


EXT:RACT PATH=ALL 


INCLUDE VOLSER=VOL* 


//DAIN 
DD * 


TYPERUN FUNCTION=MOVE 
I* 
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Example2 


In this example, utility CTTSPI, extracts the recovds of all datasets beginning with 
MY.FILE. The records for these datasets and the associated volumes are copied (not 
deleted) from the source Media Database and placed in the extract file (REPI1.>ATA) to be 
used later as input for utility CTTMER.. 


II 
EXEC C'l'TSPL 


/ISYS:CN 
DD * 


EXTRACT PATH=ALL 


INCLUDE DSNAME=MY.F:CLE* 


I* 


llDA:CN 
DD * 


TYPERUN FUNCT:CON=COPY 


I* 


Return Codes 


0 


8 


12 


16 


20 


Operationi performed success£ully. 


Initialization problem 


Extract failed 


Split failed 


Simulation' mode is not allowed while restallt is requfred. 


Greater thani 20 
Severe erroll - the erroll is accompanied by a message describing the 


problem 
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CTTSTK - Build and Update Stacking Statistics File 


This utility builds and updates the Stacking Statistics file. The utility should be run: on: a 
regular basis viajobCTTDAY. 


The utility accepts input from one of the following three types 0£ datasets:. 


• System Management Facilities (SMF) accumulated type 15 records (not the actual SMF 


files) 


• Trace file records 


• Media Database reco:rids 


Input reco:vds can be selected acco:vding to INCLUDE/EXCLUDE statements supplied to 
the utility. Record timestamps are registered in: the dataset .. Reco:vds from different utility 
runs with earlier timestamps are considered duplicate reco11ds and are dropped. Therefo:ve, 
reco11ds with overlapping timestamps from different source computers should not be 


supplied, to the utility in the same run .. 


Activating the Utility 
II EXEC 


//SYSIN 


C'l"l'STK 


DD * 


TYPERUN MODE=SMFj'l'RCjMDB 


<INCLUDE/EXCLUDE STA'?EMENTS> 


II 


Parameters 


Utility parameters are supplied via DD statement SYSIN: 


TYPE RUN 
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Statement type. 


MOBE 
Source 0£ input reco:vds. 


SMF 
Input records come from accumulated SMF type 
15 records. 


In this mode, pa:vameter SMFIN (supplied to 


p11ocedure C'ITSTK) specifies the· name of a file 
containing accumulated SMF records. 


TRC 
Input records come fromithe Trace file. 


MDB 
Input records come from the Media Database. 
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INCLUDE/EXCLUDE 


The scope of the utility can be limited by one or more INCLUDE or EXCLUDE statements. 
The subparameters which can be specified, in INCLUDE/EXCLUDE statements are listed 
in Table 3 in "Logical Field Names for the CONTROL-T Repository" in Appendix D. 


For additional, information on, INCLUDE and EXCLUDE Statements, see "Record 
Selection Logic (INCLUDE/EXCLUDE Statements)" earlier in this section,. 


Return Codes 


0 


4 


8 


12 


16 


20 


24 


Operation performed successfully 


Input statement(s) missing 


DCB open' error occurred 


Input statement parsing error occurred 


CONTROL-T Control Table (TCT) load failed 


Sort error occurred 


Media Database/ Stacking Statistics file /Trace file I/O error occurred 
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CTTTPI - Tape Initialization, Information Mapping, and 
Tape Erasure 


The utility pvovides the following majov functions: 


• Safe Tape Initialization' (INITT) 
Initializes tapes and cartridges. Checks that a 
volume is not active before initializing it, thereby 
ensuring that active volumes are not accidentally 
initialized. 


• Media Information Mapping (TAPEMAP) 
Produces a detailed report about the logical, and 
physical content of a volume including logical 
files, labels, tape marks, and um:eadable areas 
(110 errors). 


• Safe Tape Erasure (TAPERAS) 
Physically erases the contents of a volume. 


These functions are described in detail. 


Checks that a volume is not active before erasing 
it, thereby ensuring that active volumes are not 
accidentally erased; 


Multiple jobs or started tasks can run utility CTTTPI in pavallel on separate tape drives 


fov distinct ranges of volume serial numbers. 


(See "Preventing Unauthorized Access to the Tape Initialization, and Information Mapping 
Utility (CTTTPI)" in the CONTROL-T Section of the IOA se·curity Guide;) 


Safe Tape Initialization - Function INITT 


Utility CTTTPI protects active volumes fromi initialization by checking the specified 
volume serial number and the mounted' volume before creating tape labels .. Volumes al'e 


protected regardless ofi whether ov not they appear in 
1 the Media Database (MDB). 


To initialize tapes, utility CTTTPI normally invokes IBM's tape initialization utility 
IEHINITT. A comparable utility can be substituted via parameter specification, Utility 
CTTTPI' initializes magnetic media (tape-reels and, ca:r~tridges) with standard labels (SL) or 
with ANSI standard labels (AL). 


The initialization function is generally invoked as a started task via the command: 
s 
C'r'l'TPI,V=volser,[U=unitnameldevnum,JF=INIT 


This command invokes the utility with the single control statement: 


INITT SER=volser,NUMBTAPE=999 


When invoked, in this manner, the utility first checks that the specified target volume 
serial number is either not in, the Media Database OJJ is in, the Media Database with 
scratch status. 


If the target volume serial number passes the first check, the utility requests that the 
operator mount the physical volume. Once the volume is mountedi the utility reads it to 


veri.fy that it is not an1 active volume in the Media Database. 


If both the specified target volume and the physical mounted volume pass the checks, the 
desired label is written on the mounted volume. 
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If the specified volser is numeric, the utility requests successive volumes ini ascending 


011der until stopped 011 canceled by the operator. 


The utility issues messages (e.g., CTT289A) and sometimes p11ompts the operator fo11 a 
repl!Y or decision. 


If CONTROL-0 or CONTROL-0/PC is installed at your site, responses to the messages can 


usuall;y be automated~ 


Depending on specified. parameters, the Media Database can be updated by the utility. 


Media Information Mapping· Function TAPEMAP 


Utility CTTTPI can produce a detailed report about the logical1 and ph!Ysical content of a 
volume including logical files, labels, tape marks, and unreadable areas (I/0 erroris). 


This function' is especially useful when recovering files and/or data which have been 
partially-overwritten on magnetic media (e.g., a longer file pa11tially overwritten by a 


sho11ter file, 011 multi-file volumes in which the first few files have been overwritten). 


The tape mapping function is generally invoked as a started task via the command: 
s 
C'l"l'TPI,[V=volser,] [U=unitnameldevnum,]F=MAP· 


This command, invokes utility CTTTPI with the single control1 statement: 


TAPEMAP SER=volser 


The TAPEMAP function produces a reporit which contains a single line for each of the 
following elements:. 


Element 


VOLl 


HDRl 


HDR2 


DATA BLOCKS 


EOFl 


EOF2 


EOVl 


EOV2 


Tape Mark 


1/0 Error 


Description 


Volume label. 


First part (and sometimes the only part) of a header label· which 
describes a standard label dataset. 


Second part of a dataset label. 


Actual data portion, of a file on the media~ 


First part of a dataset trailer labeh 


Second part of a dataset trailer labeh 


First part of an End~Of-Volume tape label. This element appears 
when the preceding standard label· dataset continues on another 
volume. 


Second part of an End-Of-Volume tape label. 


Physical: indication on the media which separates one physical file 


from: another and. separates standard labels from data. Two 
consecutive tape marks commonly determine the logical end of the 
recorded area on the media~ 


Area which could not be read by CTTTPl. 
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The TAPEMAP function reports information extracted from: the above elements such as 
the dataset name (i.e., the fuU dataset name if it does not exceed 17 characters, or the last 
17 characters ofi a longer dataset name), creation date, creating job name, block size, 


physical and logical file sequence numbers. 


Physical file sequence numbers are counted by tape marks. Each tape mark on the tape 
indicates an: end-of~file. Logical file sequence numbers are extracted from HDRl. If there 
is no HDRl on: the tape (e.g., an NL tape), the logical file sequence number is blank. 


If a map of the complete media is requested (parameter STOP=N, described later), 
datasets written beyond the present logical end ofi the recorded area can be examined. 


Safe Tape Erasure - Function TAPERAS 


Utility CTTTPI' protects active volumes from: being erased by comparing the specified 
volume serial number and the volser ofi the mounted volume, befove erasing the data on 
the tape. Volumes are protected regardless ofi whether or not they appeav in 1 the Media 
Database. 


Utility CTTTPl uses an: MVS function· ('Data Security Erase' EXCP), to erase tapes. This 
function writes a random pattern1 of data on: the specified tape. 


The erase· function. is genevally invoked as a started task via the following command: 


S CTTTP~,V=volser,[U=unitnameldevnum],F=ERAS 


where: 


volser 


unitname 


devnum· 


Volume serial number o:Hhe tape to be erased. 


Type of the unit in 
1which the specified tape is loaded. 


Number ofi the device in which the specified tape is loaded. 


This command invokes the utility with the following single control: statement: 


TAPERAS SER=volser,NtJMBTAPE=999 


When invoked in this manner, the utility first checks that the specified target volume 
serial number is either not in the Media Database or is in the Media Database with 
scratch status. 


If the target volume serial number passes the first check, the utility requests that the 
operator mount the physical volume; Once the volume is mounted, the utility reads it to 
verify that it is not an: active volume in the Media Database. 


The mounted volume is erased only if the volser ofi the mounted volume matches the volser 
specified in the JCL for the utility. 


If the specified volser is numeric, the utility requests successive volumes in ascending 
order until stopped or canceled, by the operato11. 


The utility issues messages (e.g., CTT289A) and sometimes prompts the operato11 fol' a 
reply Ol' decision. If CONTROL.-0 or CONTROL.-0/PC is installed at your site, responses to 
these messages can usually be automated. 


Depending on specified parameters, the Media Database can be updated by the utility. 
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CTTTPI and J/O Error Recovery 


Since utility CTTTPI' thoroughly examines magnetic tapes in1 unknown, condition> it may 
encounter more I/O errol's than' 011dinary programs might encounter. In particulal', 


CTTTPI encounters I/O errors when reading a new tape to which data has never been 
written. While CTTTPl handles most of these errors successfully, the user may observe 


pe11tinent error messages 011iginated by MVS. No11mally these messages can' be igno11ed. If 


you have automation procedures driven by these messages, they should possibly be 


adjusted 
1 to exclude tape initialization and media swapping jobs. 


To minimize the overhead,ofI/O error recovery, CTTTPI'turns offDDR/SWAP capability in 
the allocated device fo11 a sho11t duration, while it reads the label of a mounted tape to be 
initialized. If CTTTPI' is canceled during that shoJ.lt period, the device may be left in, a state 
where it is not a candidate fo11 DDR/SWAP. 


The operator can increase control: over DDR/SW AP via MVS commands G OFF and G ON. 


Note 
In some cases the I I 0 error encountered by CTTTPI is due to incompatible recording 
formats of different device types. To avoid the destruction of media originally created 
by another device, care should be exercised in handling the mounted volume, in 
examining the 110 error messages on the console;. and in specifying the CTTTPI 


protection parameters. 


fo, particula11, utility CTTTPI recognizes volumes which have never been accessed, by the 
occurrence of an1 I/O error when it reads the labeh If a 3480 device attempts to read a 
cartridge written, by a 3490 device, an' I/O error message is issued by MVS indicating 
format incompatibility, and the ca11tridge is treated, by CTTTPI as a media to which data 
has never been written. In some cases the cartridges can1 be overwritten by a 3480 device. 
If your site has both media types and you want enhanced p11otection against the accidental 
mounting 0£ cartridges created by a 3490 ·device and their reinitialization by a 3480 device, 
specify PROTECT=PROMPT. 


Activating the Utility 


The utility can' be activated as a job, started task (STC), or program called from within 
another program. 


Parameters can, be passed tothe·utility in, either of the following ways: 


• Via the EXEC statement. 


• Via the SYSIN DID statement. 


However, do not use both methods at the same time. 


Passing Parameters via the EXEC Statement 


When1 passing parameters via the EXEC statement, the statement format is: 


II EXEC CT'l"l'P:C,V=volser,[U=unitnameldevnum.,]F=:rN:CTIMAPIERAS 
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: 
Where: 
1"-" 


V 
Six-character volume serial number. Valid' for !NIT, MAP, or ERAS 
functions. Optional, 


F 
Function to. be perfornned using default control statements. Valid 


functions are: 


u 


!NIT 


MAP 


ERAS 


Initialize the tape (reel or cartridge). Create a volume labeL 


Map. the tape: Provide information' about the contents of a 
reel or cartridge. 


Erase the data on the tape. Write a random' pattern from 


the beginning until the physical1 end .. of-tape. 


Tape drive to be allbcated for use by the utility. Valid values are a generic 
or esoteric unit name or a specific device number. 


Passing Parameters via DD Statement SYSIN 


When passing parameters via DD statement SYSIN, the syntax is: 


II EXEC 
C'r'l'TP:C 


llSYS'I.N 
DD * 


'l'YPERUN 
[MODE=NORMALjS'I.MtJt.AT'I.ON] 


'I.N'I.H 


[, PROTECT=ALL I MDB I PROMPT I NOREAD]. 


[, MDBUPDAT=Y IN] 


[,ADD=NjYjEjPl 


[,PROG=labeling-program] 


SER=volser 


[, DDNAME=ddname] 


[, OWNER=owner] 


[,NUMBTAPE=number] 


[, LABTYPE=AL] 


[, ACCESS=char] 


[, ERASE=Y IN] 


TAPEMAP 
SER=volser 
[, DDNAME=ddname] 


[,NUMERR=number] 


[, STOP=Y IN] 


[,MODE=S IE] 


TAPERAS 
SER=volser, 


9-188 


[DDNAME=ddname] 


[,NUMBTAPE=number] 


[, ERASELBL=Y IN] 
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Input Parameters - SYSIN DD File 


Note 
Throughout the documentation, the term "specified volser" refers to the volume serial 
number specified in parameter SER=volser. The term "mounted volume" refers to the 
physical volume (and its label, if one exists) which was mounted with the intent of 
writing a new volume label on it. 


TYPER UN 
Provides general info11mation1 affecting the remainder of the run. 
Optional. Valid only fo11 function. INITT. 


Only one TYPERUN statement can be specified in each run of 


CTTTPI'. When, specified, it must be the first statement. 


MOBE 


PROTECT 


Controls the· operation, of function1 INITT. Optional. Valid 


values are: 


NORMAL 
The utility creates labels on the media 
and performs other requested functions. 
Default. 


SIMULATION 
The utility only verifies that the 
specified target volume either does not 
appear in the Media Database 011 it 
appears in the Media Database in 


scratch status. The physical mounted 
volume, however, is not read and not 
initialized. 


When1 this mode is used, mounting the 


target volume is not required~ 


Controls the protection of the physical mounted volume. 
Optional. Valid only for function1 INITT. Valid values are: 


ALL 
Default. Protects aU mounted volumes, 
as follbws: 


• Mounted volumes which we active in 
the Media Database are rejected 
without a prompt to the operator. 


• Mounted volumes which have never 
been written, to are accepted without 
a prompt to the operator. 


Note 
Media created on a 3490 · may 
be 
treated 
as 
empty 
by 


CTTTPL See "CTTTPI and 
I I 0 Error Recovery" above for 
more information. 
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MDB 


NO READ 


PROMPT 


CTTI'PI 


• Mounted SL volumes which we not in 
the Media Database result in a 
prompt to the operator. 


• NL volumes which contain, data result 
in a prompt to the operato11. 


• A mounted SL scratch volume whose 
volume serial, number is the same as 
the specified target volser is accepted 
without a prompt to the operator 
(reinitializing the existing volume). 


• A mounted SL volume whose volume 
serial number exists in' the Media 
Database in scratch status but whose 
volume serial number is not the same 
as the specified twget volser results 
in a prompt to the operator. 


Protects mounted volumes only if they 
are in1 the Media Database; The 
mounted volume is protected: in' the 
same manner as in PROTECT=ALL, 


except that SL volumes which are not in 
the Media Database are accepted 
without a prompt. 


Mounted volumes are not read or 


otherwise protected before· writing a 
new label' on them. 


Note 
Verification of the specified 
target volume serial number is 
still. performed subject to other 
parameters. 


Mounted volumes are read and the 
operator is requested to approve the 


initialirlation of the mounted volume. 


MDBUP1'AT Controls updates to the Media Database record of the 
specified twget volume. 
Optional~ Valid for function 
INITT only. Cannot be used in SIMULATION mode. Valid 
values are:. 


Y (Yes) 
Default. If the volume is already in the 
Media Database, the information in, its 
record is reset, 
including volume 
statistics and infoJmlation regarding 
scratch datasets which have resided on 
the volume. 
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• The value of the last job to· access the 
volume is changed to··*C'ITI'PI*. 


• If the volume is not in1 the Media 
Database and ADID= Y is specified; the 
volume recovd is added to the Media 
Database. 


No changes are made to the Media 
Database as a result of the initialization 
process. 


If MDBUPDAT=N is specified, parameter 


ADID is ignored, 


ADIJ> 
Controls the handling of specified volume serial1 numbers 
which are not in the Media Database. Optional, Valid for 
function INITT only. Cannot be used in' SIMULATION 
mode.Valid values ave: 


PROG 


N(No) 


Y (Yes) 


E (External~ 


P(Prompt) 


A volume record is not added to the 
Media Database. Default. 


A volume recovd is added to the Media 


Database. 


A volume recovd is added to the Media 
Database and maxked ExtemaL 


The operatov is prompted to decide 
whether or not to add a record to the 
Media Database. 


Labeling program: name: Allows users to replace IBM's 
IEHINITT with another program1 which physically writes 
labels on volumes, or allows program1 IEHINITT to be 
used under a different name. The program name can have 
a maximum of 8 alphanumeric chwacters. The default is 
IEHINITT. Optional, Valid fov function: INITT only. 


Initialization' function' Controls initialization (ov initialization' simulation) 
ofi magnetic media volumes. Optional1 If this control, statement is used, at 
least one optional subparameter must be specified: 


SER 
Volume serial number to be initialized (up to 6 
alphanumeric characters) .. Mandatory. 


This parameter is identical to· parameter SER= in IBM 
utility IEHINITT. 


Note 
A volume serial number specified in I I EXEC 
CTTTPI, V=volser or passed to the program as 
PARM='CTTTPIV=volser' overrides this value. 
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NUMBTAPE Maximum number of: tapes to·be initialized. Optionah 


After the fi11st specified volume is p11ocessed, the numeric 
suffix of the volume serial' number (if one exists) is 
repeatedly incremented by one to generate additional 
serial1 numbers, until the number of tapes initialized 
equals the value of NUMBTAPE 011 until a volume is 
initialized with a volse11 whose suffix is all 
9~s. 


NUMBTAPE must be an integer between: 1 and 9999. The 
default is l. 


OWNER 


LAB TYPE 


ACCESS 


DDNAME 


MEDIA 


VENDOR 


ERASE 


Owne11 identification' to be reco11ded on, the volume label. 
Maximum: 10 alphanumeric chwacters. (This pa11ameter 


is identical1 to parameter OWNER= in IBM utility 
IEHINITT.) Optionah 


Type of label to. create. Optional. (This pa11ameter is 
identical' to pwameter LABTYPE= in IBM utility 
IEHINITT.) If this parameter is omitted, an, IBM standard 
label is created, Otherwise, the following value is valid: 


AL 
Create an 
1 ANSI standard label. 


Protection character fo11 ANSI standwd, label. (This 
parameter is identical1 to parameter ACCESS= in IBM 
utility IEHINITT.) Optional, 


DB name for the tape drive to be used by CTTTPI. The 
ddname must start with the chwacters CTTTPl. The 
default value is CTTTPITP. Optional'. 


Volume media name to· be recorded in the Media Database 
for volumes being added to· the Media Database as part of 
the initialization process. The media must be defined in 
member CTTP ARM. If no· value is specified, the media 
name is derived from the device type of the assigned tape 
drive (e.g., MEDIA=3480) .. 0ptionaL 


Media vendor name to· be reco!'ded in the Media Database 


fol' volumes being added to the Media Database as part of 
the initialization' process. Optional' 


Indicates whethel' or not to erase all data on, the tape from 
afte!' the labeluntilthe physical end~of~tape. 


Y (Yes) 


N(No) 


Erase the data on the tape .. 


Do not erase the data on1 the tape. 


Note 
Since the ERAS /Unction physically writes a 
random pattern of data until the physical end of 
the tape, a run of utility CTTTPI in which 


ERASE=Y is specified can be a time-consuming 
process. 
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Erase function. Controls erase (or erase simulation) of magnetic media 
volumes. Optional. The following subparameters are available for this 
function:: 


SER 


NUMB TAPE 


DD NAME 


ERASELBL 


Volume serial1 number to be erased (up to 6 alphanumeric 
characters). Mandatory. 


Note 
A volume serial number can also be specified as 
follows: 


II EXEC C'l'TTPI,V=volser 


or it can be passed to the program as follows: 


PARM='CTTTP:CV=volser' 


which overrides the volser in the EXEC statement. 
Both these statements override the value specified 
viaparameter SER. 


Maxi.mum number of tapes to be erased. Optional. 


After the first specified, volume is processed, the numeric 
suffix of the volume serial number (if one exists) is · 
repeatedly incremented by one to generate additional 
serial 
1 numbers, until: the number 0£ tapes erased equals 
the value 0£ NUMBTAPE or until a volume is erased with 


a volser whose suffix is all 
1 9!s. NUMBTAPE must be an 
integer between1 l and' 9999. The default is 1. 


DD name fo11 the tape drive to be used by utility CTTTPI 
1 
• 


The ddname must start with the characters CTTTPI'. The 
default value ·is CTTTPITP. Optional. 


Indfoates whether or not to erase the label of the volume. 
OptionalL 


Y (Yes) 


N(No) 


ERASE the label. 


Keep.the label. Default. 


Tape mapping function. Optional. If this parameter is used, at least 
one optional subparameter must be specified: 


SER 


DID NAME 


NUMERR 


Volume serial: number to appear in1 the mount message. 
This volume serial number does not have to match the 
volume serial1 number recorded on the media. Optional. 


Name of the DD statement identifying the tape drive to be 
used by CTTTPI'. The ddname must start with CTTTPI. 


The default value is CTTTPITP. Optional. 


Number of I/O e:m'ors (between 1 and, 999) which will cause 
utility CTTTPl toterminate .. Default is 1. Optional. 
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MODE 
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Controls termination, of the TAPEMAP function, Optionah 


Y (Yes) 


N(No) 


Default. The TAPEMAP functioni ends when, 
one of the follbwing is encountered: 


• Logical End-of•.Volume as indicated by: 


- 
Two consecutive tape marks, or 


- 
End~of-Volume label follbwed by a tape 


m0.11k. 


• The maximum, number of 1/0 errors 


permitted 
(specified 
in 
parameter 


NUMERR=) ·has occurred~ 


Function TAPEMAP ends only when canceled 
by the operator or when it encounters an error 
it cannot ignore. 


Note 
Processing a volume with STOP=N 
may cause unexpected operational 


problems, such as a tape running off 
a reel, or unusual I I 0 errors. 


It is recommended that STOP=N be used only in a test 
environment where unexpected problems will! not disrupt 


p11oduction. 


Controls both the extent of the report produced by the 
TAPEMAP function1 and' the way in which this function, 
reads the tape. 


E (Extended) Produces a report on all datasets that exist on 


the volume including datasets that exist after 
the logical end of data (see value N for 
subparameter STOP above). When operating 
in this mode, utility CTITPI physically reads 
every byte on' the volume.. This mode is 
therefore time·consuming: Default. 


S (Standard) Produces a report oni all' datasets that exist on' 
the volume up to the logical' end, of data; The 
utility scans the datasets on the volume, it 


does not physically read the data; This mode 
is therefore quicker than' Extended mode. 


When MOIDE=S is specified, subparameter STOP is 
ignored and field LARGEST BLOCK produced by utility 


CTTTPl is set to zero .. 


JOA Rel. 5.0.0 Administrator Guide 


u 


u 


u 


u 


u 


CTTTPI 
Section 9: Utilities 


Invoking CTTTPI From Another Program 


When, calling CTTTPI as a program from within' another program: 


• Input parameters for CTTTPI' should be passed only via DD statement SYSIN. Do not 
specify input parameters in the JCL EXEC statement. 


• Linkage and parameter-passing conventions for utility CTTTPI' are the same as for IBM 
utilities (see the IBM Utilities Manual~. 


• Utility CTTTPI' supports substitution of DD names for its SYSIN and SYSPRINT 


statements viathe same parameters used by IBM utilities (see the IBM Utilities Manual). 


When constructing jobs which invoke CTTTPI, copy the DD statements from the CTTTPI 
JCI:.. pl'ocedure as follows: 


SYS IN 


SYSPRINT 


DAMDB 


DAMDl 


DALOG 


DATRC 


CTTTPITP 


CTTTPICT 


Input Stream. 


Output stream for CTTTPI and for IEHINITT (or specified substitute). 
This DI> statement must point to a SYSO'NT file Ol' the results can be 
unpredictable. 


Media Database Data component. 


Media Database Index component. 


IOA Log file. 


CONTROL-T Trace file. 


Tape drive for tape initialization. 


Intermediate file for transferring control: statements to IEHINITT. 
The name of this DD statement cannot be overridden in the utility 
invocation. 


If program CTTTPI is called; from within1 another p11ogram:. 


• CTTTPI' passes control statements to IEHINITT (or specified substitute) via DD statement 
CTTTPICT. 


• PARM= parameters can1 be passed to IEHINITT (or specified substitute) by passing the 
parameters to· CTTTPl'.. 


• One PARM= parameter, CTTTPIV=volser, is utilized only by CTTTPI and is not passed to 
IEHINITT (011 specified substitute). 


If specified, the volume serial number must be the first PARM= parameter (i.e., it must 
precede any parameters passed to IEHINITT) and must be exactly 6 characters in length 
(e.g., PARM='CTTTPI'V=VOL001,LINECNT=60'). This volume serial number will replace 
the volume serial number in the first occurrence of parameter SER= in an INITT or 
TAPEMAP statement in CTTTPI's input stream. 
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Return Codes 


Upon completion, CTTTPI' returns one of the following return codes (in register 15): 


0 


4 


8 


12 


16 


20 


24 
28 
32 


36 


40 


44 


Example 


Successful completion, 


Operato11 requested termination by typing CANCEL in response to a 


p11ogram p11ompt 


The specified target volume is a non-scratch volume in the Media 
Database 
The Media Database could not be updated 


MDBUPDAT= Y was specified, but the specified target volume is not in 
the Media Database and the volume could not be added (i.e., either 
ADD=N was specified or the operato11 responded negatively to the 
ADD p11ompt) 


Syntax erro11 in control· statements 011 parameters 
IEHINITT (or the specified substitute) failed 011 was stopped by the 


operato11 


Error while opening the IOA Log file 


Erro11 while loading IOA modules 011 tables 


Unable to open DD file CTTTPlxx fo11 accessing a tape dr:ive 


Unable to open DD file SYSPRINT 011 its replacement 
Unable to open DD file SYSIN or its replacement 
Error while accessing the Media Database 


Below is a sample ofTAPEMAP output with STOP=N. 
15.33.04 C'r'1'704:C CONTROL-T UT:CL::CTY C'r'l'TPJ: 
STARTED 
15.33.04 C'r'1'700:C 
TAPEMAP SER=CTTMAP,STOP=N 
VOLl 
V=VOOOOl 


HDRl 
DSN= ••• NOPOOL.F.G0028VOO 
F:CRST=VOO~OO, VOLSEQ=0002 
F:CLESEQ=0002 CBEDT=94346 


HDR2 
CREA'l'-JOB=N77MULO~ 
BLKSZ=00080' 
LRECL=00080' 


RECFM=F 


TAPE-MARK 
--------- 
DATA BLOCKS: COUNT=00000005 
LARGES'l'-BLKSZ=00080 
LOG:CCAL-F:CLE 
-SEQ=0002 PHYS:CCAL-F:CLE-SEQ=00002 


TAPE-MARK 
--------- 


EOFl 
DSN= ••• NOPOOL.F.G0028VOO 
EOF2 


TAPE-MARK 
--------- 


TAPE-MARK 
--------- 
**** LOG:CCAL END OF RECORDED AREA **** 


:CO-ERROR 
********* 
DATA BLOCKS: COUNT=00000051 
LARGEST-BLKSZ=03120 
LOG:CCAL-F:CLE 
-SEQ=PHYS:CCAL-F:CLE-SEQ=OOOOS 


TAPE-MARK 
--------- 


EOFl 
DSN=NNN.TSCl 
EOF2 


TAPE-MARK 
--------- 


TAPE-MARK 
--------- 
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CTTTRB - Synchronize Trace File aild Media Database 
Backup 


This utility marks reco11ds in the Trace file that are no longer needed, so that they can: be 
overwritten. This utility should be run immediately befo11e and a£ter each backup of the 
Media Database and the Trace file. 


The Trace file is used p11imarily to trace actions perfo11med on the Media Database. When 
the Trace file becomes full, all CONTROL-T functioning is halted and an app11opriate 
message is issued. This situation can be avoided by running utility CTTTRB on a regular 
basis. This utility is called by the CONTROL-T New Day procedure before and after the 
daily backup of the Media Database and 
1the Trace file. 


Activating the Utility 


II EXEC 
CTT'rRB>PABM='BKP=S'rAR'rlEND' 


Parameters 


Utility parameters are supplied via JCL PARM: 


BKP 
Indicates if the Backup procedure is beginning or ending. 


START 


END 


Backup procedure of Media Database has started. 


Backup.procedure of Media Database has ended. 


The steps for implementing utility CTTTRB a11e as follows: 


1. Run the utility before backup of the Media Database and the Trace file. In this run 
BKP=START ·must be specified. This run of the utility marks the most recently filled record 
in the Trace file. 


2: Perform: the necessary backups. Any local: site backup procedu11es can: be used to perform 
this task. 


3. After the backup has been successfully completed, run: utility CTTTRB with BKP=END 
specified. This run, marks aU Trace file reco11ds befo11e the reco11d marked in, the p11evious run 


o£the utility (Stepl above). 


Return Codes 


0 


8 


12 


Example 


Operation perfo11med successfully 


DCB open error occurred, TCT load failed, or PARM error 


I/O error on Trace file occurred 


II EXEC 
CT'rTRB,PABM='BKP=STAR'r' 
II EXEC 
PGM=~EBGENER 


II EXEC 
CTTTRB,PABM='BKP=END' 
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CTTUDB - Update the Media Database Fl"om Transaction 
File 


Utility CTTUDB modifies the Media Database (MDB) acco11ding to a transaction file. The 
transaction file can be created either by utility CTTIDB 011 by manually editing a 
sequential file. For each transaction reco11d, the utility verifies the data being changed, 
and issues a message specifying the type and the content of the changed field befove and 
after the change. 


Activating the Utility 


Note 
The SYSIN statement and the MTU parameter are optional. 


II EXEC 
CTTUDB,M'l'U='transaction-file' 


llSYSJ:N 
DD * 


'l'YPERUN 
MODE={NORMAL!SJ:MULATI:ON} 


Parameters 


The following parameter is specified in the EXEC statement: 


MTU 
Name of the transaction file to be used by utility CTTUDB. Optional; 
if not specified, an installation-defined default is used. 


The following parameters are supplied via DD statement SYS IN: 


TYPER UN 


Return Codes 


0 


4 


8 


12 


16 


Greater than 16 
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Statement type. 


MODE 
Operation mode. Mandatory 


NORMAL 
Normal operation, is performed. 


SIMULATION 
Simulation' is performed. No actual changes are made 
to the Media Database. 


Operation performed successfully. 


Verification 0£ one 011 move data items in the Media Database failed - 
Execution' continues 


Invalid input from transaction' file - Execution continues 


Invalid control1 parameter given - Execution terminates 


Error opening DCB - Execution terminates 


Severe erro11 - the erro11 is accompanied by an: app11op11iate message 
indicating the problem - Execution, terminates 
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CTTVTM • Perform Vault Management 


This utility perfo11ms vault management functions. This utility should be run on a regular 
basis viajob CTTDAY. 


The utility checks each volume recovd's vault specifications in 
1 the Media Database and 
determines which volumes should be moved to a new location acco11ding to their vault 
patterns. The current volume location1 in the volume record is updated, 


This utility can produce a distribution report at the end of processing, which lists all 
volumes which, should be moved to a new location or assigned a new slot number. 


Note 
Inventory report INVENT is no longer produced by utility CTI'VTM. Instead,. this report 
can be produced as part of the GENERAL report by utility CTl'RPT. For more information 
see the description of utility CTl'RPT in Section 5 of the CONTROL-T User Manual. 


Since the utility handles a large number ofi Media Database records, a CANCEL operation, 
job abend or systemi crash can 
1 lead to, logical inconsistencies in1 the database. After any of 
these situations, the next execution of the utility will automatically operate in Restart 
mode. In Restart mode, the utility will complete execution1 ofi the failed process, thereby 
eliminating the logical errovs from the Media Database. The utility does not move any 
additional volumes during Resta11t execution~ 


Certain installation' pa11ameters (specified in 
1 member CTTPARM) determine how utility 
CTTVTM operates. These parameters ave described below. 


VLTBYDSl 
Specifies which dataset may determine how the vaulting pattern. of a 


volume is chosem Valid values are: 


Y (Yes) 


N(No) 


Only the first dataset of the volume determines the 


vaulting pattern for 
the volume. 
This 
improves 
performance of CTTVTM (and is compatible with other 
Tape Management Systems vaulting methods). Default. 


Any dataset can determine the vaulting pattern for the 
volume .. 


CYCLECNT 
Defines how to handle cyclic datasets. 


For additional info:rimation refer to 1 "Retention and 1 Vault Parameters" in the IOA 


Installation1 Guide .. 


Activating the Utility 


II 
EXEC 
C'l'TVTM 
llSYSIN 
DD* 


II 


TYPERUN 
MODE=NORMALISJ:MtJLATION[,DATE=da~e] [,TRACE=YESINO] [BOXLIM=num] 
TYPEVLT 
MODE=REGUIIAR I RECALC I CONVERT I SLOTBLD I BOXBLD [, RESLOT=YES I NO] 


<INCLUDE/EXCLUDE STA'l'EMEN'l'S> 
REPORT 
NAME=DISTRIB1 ••• 
FIELDS ••• 
SORTBY ••• 
ATTR 


BREAK ••• 
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Parameters 


Utility parameters are supplied via DD statement SYSIN: 


TYPER UN 
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Operation type. 


MODE 


DATE 


TRACE 


Operation' mode .. Mandatoey. 


NORMAL 
Normal operation: is perfo11med. 


SIMULATION 
Simulation is 
performed~ No actual1 


changes are made to the 
Media 
Database 


Operation date in 6- or 8-character format according to 
site standavd with separating slashes. (FoI1 example, in 1 
USA standard the date can be specified mm/dd/yy or 
mm/dd/yyyy.) Optional. 


The utility assumes that the specified date is the current 
date, and performs vaulting accoI1dingly. This parameter 
can, be used together with MODE=SIMULATE (described 
above) toisimulate vaulting to 1be done on a specific date in 
the futuve .. 


Specifies whether or not the Trace file will be used during 
CTTVTM run. Optional' 


YES 


NO 


The Trace file will be used. Default. 


The Trace file will not be used. If NO is 


spl:lcified, recovery of the lost updates to 
the Media Database will be impossible. 
TRACE=NO is specified for the run1 of 
this utility during conversion from 


another product, but is not otherwise 
recommended. 


DBGLEVEL 
Debug IeveL A numeric· value from 1 to· 255 can be 
specified. Optional• 


RESTART 
Specifies whether or not to enable Automatic Restart mode 


when 
1 the utility is run after an abend or cancellation: of the 


p11evious run, of the utility. Valid values ave: 


BOXLIM 


YES 


NO 


Enable 
Automatic 
Restart 
mode. 
Default. 


Disable Automatic Restart mode. It is 
highly recommended not to specify 


RESTART=NO, as this can result in 
integrity errors in the Media Database 
and loss of important information. 


Minimum number of volumes a box can, contain, If the 
number of volumes is below the minimum, the volumes 
are placed: in a slot instead of a box. Default is 1. 
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Vault management type. Optional if parameter REPORT is specified. 
If TYPEVLT is not specified, vault processing is not performed but 


repo11ts are p11oduced .. 


MODE 


RE SLOT 


Vault management mode. 


REGULAR 


RECALC 


CONVERT 


SLOTBLD 


BOXBLD 


Vault 
management 
is 
performed 
according 
to 
the 
vault 
patterns 
currently specified for the volumes (in 
Media Database volume records). 


Rule definitions are reloaded and the 
vault pattern1 
of each volume 
is 


recalculated, 


This pwameter is 
used following 
conversion1 
from 
another 
tape 
management system, Rule definitions 


we reloaded, the vault pattern for each 
volume is calculated, and the current 
location of each volume is reserved 
within the vault pattern. 


The slot map is built in the Media 
Database. This mode cannot be specified 
if RESLOT= YES. 


Box records we built in the Media 
Database from the vault definition and 
volume records. This mode cannot be 
specified if RESL.OT= YES. 


Specifies whether or not to reassign slot numbers to 
vaulted volumes. Optional. 


YES 


NO 


New slot numbers wiU 


1be assigned. 


Existing slot numbers will! be preserved~ 


Default. 


The scope of the utility can be limited by one 011 move INCLUDE or 
EXCLUDE 
statements. 
INCLUDE/EXCLUDE 
statements 
are 
specified immediately after the TYPEVLT parameter and are applied 
to vault p11ocessing. The subparameters which can, be specified in 


INCLUDE/EXCLUDE statements are listed in, Tables 1 and 2 in' 
"Logical Field Names fo:r~ the CONTROL-T Repository" in1Appendix D. 


Note 
As of CONTROL-T Release 2.1.0, INCLUDE/ EXCLUDE 


statements cannot be specified after SORTBY parameters. 
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REPORT 


Fl'ELDS 
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Fo11 additional infoI1mation on INCLUDE and EXCLUDE statements, 
see "RecoI1d Selection' Logic (INCLUDE/EXCLUDE Statements)" 
earlier in this section .. 


Note 
With few exceptions, the parameters and options of the REPORT, 


FIELDS, SORTBY, ATTR and BREAK statements are identical 
to those found in utility· CTTRPT. For a complete description of 
these parameters and options,. refer to utility· CTTRPT in Section 
5 of the CONTROL-T User Manual. Differences between utility 
CTTVTM and utility CTTRPT, in those parameters and options, 
are described below. 


Activates report utility. Optional if parameter TYPEVL T is specified. 


NAME 


DISTRIB 


Repom name .. Mandatocy. Valid value is: 


Distribution Repom listing volumes which need to· change 
location as a result 0£ this utility run, 


Notes 
Inventory report INVENT is no longer produced 
by utility CTTVTM. Instead, this report can be 
produced as part of the GENERAL report by 
utility CTTRPT. A sample Inventory report can 
be found in member REPINV in the CONTROL-T 


JCL library. 


See the REPORT statement in utility CTTRPT 


(earlier in this section of the Administrator 
Guide) for a description of the other parameters 
and options of the REPORT statement. 


Fields to print in the report. The fields are pI1inted in the o:r:der they 
are specified:. 


The following fields can be printed· on the Distribution report: 


MEDI!A 
Media type 


POC>b 
Pool: name 


VOl!.STAT 
Status(es) of the volume 


VO Ii.SER 
Volume serial number 


SL-NAME 
Standwdlabel name of the volume 


VOLCNT 
Number of volumes in a multi-volume chain 
1 


FIRSTVOJ;, 
Frnst volser in a multi-volume chain 


FROMLOC 
"From1' vault location1 of the volume 


TOI:.OC 
"To" vault location of the volume 


FROMSLOT 
"From" slot number in the vault 


JOA Rel. 5.0.0 Administrator Guide 


u 


u 


CTTVTM 


SORTBY 


ATTR 


BREAK 


Section 9: Utilities 


TO SL.OT 
"To~ slot number in the vault 


NEXTLOC 
Next location' in the vault pattern 


NEXTLCOT 
Date the volume should be moved to· the next location in 
the vault pattern 


BOXID 
Name 0£ the box in 
1 which the volume resides. 


EXPI:>T 
Expiration date 


LBLTYP 
Label type 


DSNAME 
Dataset name 


VOLSEQ 
Volume sequence number 


LOCSEQ 
Sequence number of the location in the vault pattern. 


CREJBN 
Creating job's name 


CREDT 
Creation date 


CRETM 
Creation' time 


Note 
See the FIELDS statement in utility CTTRPT 


(earlier in this section of the IOA Administrator 
Guide) for a description of the options of the 


FIELDS statement. 


Som order 0£ the output fields (see FIELDS above), with the options 
that can' be applied to, each field .. OptionaL 


Note 
See the SORTBY statement in utility CTTRPT (earlier in this 
section) for a description of the parameters and options of the 


SORTBY statement. 


Override 0£ default attributes defined for a field (see FIELDS above). 


Option ah 


Note 
See the ATTR statement in utility CTTRPT (earlier in this 
section) for a description of the parameters of the ATTR 
statement. 


Attributes of the summary header line(s) printed when a field' break 
occurs .. Optional. 


Note 
See the BREAK statement in utility CTTRPT (earlier in this 
section) for a description of the parameters of the BREAK 
statement. 
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Return Codes 


0 


4 


8 


12 


16 


20 


24 


28 


32 


other 


Example 1 


Operation, perfo11med successfolly 


Missing input statement(s) 


Missing DD statement(s), or open erro11 occurred 


Control1 card erro11 


Load of CONTROL-T programs failed 


Sort error occu11red 


Media Database input/output error occurred 


Internal erro11 occu11red 


Error in, report printing utility occm~red 


Operation is terminated 


CTTVTM 


Vault management is performed according to· the current vault pattern specifications in: 


the Media Database. Report DISTRIB is printed, listing the MEDIA, VOLSER, VOLSEQ, 
FROMLOC and TOLOC fields. 


11 
EXEC C'l"l'V'l'M 


llSYSIN 
DD * 


II 


'l'YPERUN MODE=NORMAL 


'l'YPE'VIIT MODE=REGULAR 


REPORT NAME=DISTRIB 


FIELDS MEDJ:A,VOLSER,VOLSEQ,FROMLOC,TOLOC 


SORTBY FROMLOCIB,TOLOC1VOLSER 


The report is sorted according to the location· fromi which each volume is being moved 


(FROMLOC). The report is then so11ted according to 
1 the destination• (TOLOC) and the 
volser name (VOLSER). A page bJ1eak is inserted after each FROMLOC location listed in 
the report (i.e., each group of volumes fromi a specific location will start on a new: page). 


Example2 


The location of: all volumes whose volume serial numbers start with DIV! is modified. The 
volumes are assigned new slot numbers. Rule definitions are reloaded to recalculate the 
vaulting patterns. 


II EXEC 


llSYSIN 
'l'YPERUN 
'l'YPEVLT 
INCLUDE 
REPORT 


CTTVTM 


DD* 


MODE=NORMAL 
MODE=RECALC,RESLOT=YES 
VOLSER=DIV1* 
NAME=DISTRIB 
FIELDS 
MEDU,VOLSER,POOL,FROMLOC,TOLOC 
SORTBY 
FROMLOCIB•VOLSER,POOL 


II 
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TO SLOT 
"To" slot number in the vault 


NEXTLOC:: 
Next location in the vault pattern 


NEXTLCDT 
Date the volume should be moved to the next location in 
the vault pattern 


BOXID 
Name of the box in which the volume resides. 


EXP:DT 
Expiration date 


LBLTYP 
Labeltype 


DSNAME 
Dataset name 


VOLSEQ 
Volume sequence number 


LOCSEQ 
Sequence number of the location in the vault pattern. 


CREJBN 
Creating job's name 


CREDT 
Creation date 


CRETM 
Creation time 


Note 
See the FIELDS statement in utility CTTRPT 


(earlier in this section of the JOA Administrator 
Guide) for a description of the options of the 
FIELDS statement. 


Sort ovder of the output fields (see FIELDS above), with the options 
that can be applied to each field .. Optional. 


Note 
See the SQRTBY statement in utility CTTRPT (earlier in this 
section) for a description of the parameters and options of the 


SORTBY statement. 


Override of default attributes defined' for a field (see FIELDS above). 
Optional. 


Note 
See the ATTR statement in utility CTTRPT (earlier in this 
section) for a description of the parameters of the ATTR 
statement. 


Attributes of the summary header line(s) printed when a field bveak 


occurs. Optional. -· 


Note 
See the BREAK statement in utility CTTRPT (earlier in this 
section) for a description of the parameters of the BREAK 
statement. 
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Return Codes 


0 


4 


8 


12 


16 


20 


24 


28 


32 


other 


Example I 


Operation performed successfully 


Missing input statement(s) 


Missing DB statement(s), or open, error occurred 


Control card error 


Load of CONTROL-T programs failed 


Sort error occurred 


Media Database input/output error occurred 


Internal error occurred 


Error in report printing utility occurred 


Operation is terminated 


CTTVTM 


Vault management is performed accovding to the current vault pattern specifications in 
the Media Database. Report DISTRIB is printed, listing the MEDI:A, VOLSER, VOLSEQ, 
FROMLOC and TOLOC fields. 


I I 
EXEC CTTVTM 


//SYS'I.N 
DD * 


II 


TYPERUN MODE=NORMAL 


TYPEVL'il' MODE=REGULAR 


REPORT NAME=D'I.STR'I.B 


F'I.ELDS·MEDll,VOLSER,VOLSEQ,FROMIIOC,TOLOC 


SORTBY FROMIIOC/B,TOLOC,VOLSER 


The report is sovted according to the location from which each volume is being moved 


(FROMLOC). The report is then sovted according to the destination (TOLOC) and the 
volser name (VOLSER). A page break is inserted· after each FROMLOC location listed in 
the report (i.e., each group of volumes from a specific location will start on' a new page). 


Example2 


The location of all volumes whose volume serial numbers start with DIVl is modified. The 
volumes are assigned new slot numbers .. Rule definitions are reloaded to recalculate the 
vaulting patterns. 


I I 
EXEC 
CTTVTM 
//SYS'I.N 
DD* 


II 


TYPERUN 
MODE=NORMAL 


TYPEVLT 
MODE=RECALC,RESLOT=YES 
'I.NCLUDE 
REPORT 
F'I.ELDS 
SORTBY 


VOLSER=D'I.Vl* 
NAME=DlCSTR'I.B 
MED:cA,VOLSER:,POOL,FROMIIOC,TOLOC 
FROMLOC/B,VOLSER,POOL 
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Section 10: Exits 


General 


Various user exits are available which can be used to modify the operation of IOA products 
to accommodate needs. The exits reside in· the IOA SECUDATA library, and start with 


either IOAXnnn1 or CTxXnnn~ These exits are installed using SMP/E USERMOD. To install 
an exit, locate the exit's associated USERMOD member in the IOA SECUDATA library 
(members starting with UMxXnnn1 where x is the CONTROL pIJoduct, and Xnnn refers to 
the exit number. 


Note 
Special exits may exist in some cases. The exits can be identified by the additional 
character added to the member name (e.g., IOAX006D). For this purpose, a special 


USERMOD is available for each of these exits. For example, for user exit CTI!JX015V, 


the corresponding USERMOD to be used is UMDX015V. 


A fuU explanation 0£ how to use the exits is available in, members starting with IOAIXnnn 


or DOC:IXnnn' For example, the explanation for exit IOAX006 can be found in member 


DOC:IX006 inthe SECUDATA libra11y. 


Befol'e submitting the USERMOID jobs, follow the steps. 


1. Verify that a backup of the LOAD libl'ary exists. 


2 .. Make all necessary updates to·the USERMOID: 


A. Update the PRE operand of the ++VER MCS of the usermod to include the exit SRC 


entry RMID and UMIDs. If the exit has no UMIDs and the RMID is equal to the FMID, 
the PRE operand should be omitted. 


B. Update the JCLIN (linkedit input ca11ds) ifrequi11ed. 


C. Update the source exit name in1 the SMP/D ++SRC statement if necessary. 


D. Update the library and member names of the source exit in the IOA SECUDATA library 
on the unnamed DD statement following the ++SRC statement. 


3. Submit the job: It wiU perform SMP/E RECEIVE and APPl'...Y commands, selecting the 


SMP/E usermodjust created. Do not run ACCEPT on, this usermod. 
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IOAExits 


The follbwing IOA exits are available: 


IOAX006 
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This exit controls the use of the IOA Online facility. 


IOAX006 and IOAX009 are twin exits .. IOAX006 is invoked by the 
Online facility before the entry panel is displayed .. IOAX009 is invoked 
only when signing on1 to the Online facility thvough the online monitor 
(i.e., when' signing on through the online monitor, exit IOAX009 is 
invoked fivst, followed by exit IOAX006). When the Online facility is 
used without the online monitov, only exit 6 is invoked). These exits can 
be used to· display a sign~on window for users to enter their user ID and 
password. 


These sign-on modules determine and build the user's identity fo11 all 
subsequent actions. They both have a similar structure of parameters, 
return codes, and functionality. However, they work in different address 
spaces. The home addvess space is the pvimavy address space 
requesting and' receiving services from the online monito11 address space 
using the cross-memory facilities .. Exit IOAX006 is invoked in the online 
monitor address space (when signing on' through' the online monitor), 
while exit IOAX009 is invoked in the home address space that is the 
VTAM monito11, CICS, IMS, CA-ROSCOE, etc. The control block that 
represents the user's identity accompanies the user during the entire 
session with the IOA Online services facility. 


In the online monitor envivonment, the AQEE control block is stored in 
the user's TCB (Task Control 
1 Block) and the OCT (Online Control1 Table). 


MVS recognizes the ACEE as a standard control block to be used for 


authorization· checks, so· that task level security feature is achieved. If the 


ACEE is not stored in' the TCB, either because module IOASE06 is not 
implemented 011 because the security package does not build an ACEE 


(e.g., ACF2 in1 native mode), then 
1 an authocization1 checks foll file access 
are performed using the identify of the online monitoll addvess space. All 
authorization checks are performed using the correct user's ACEE. If the 
ACEE is not built, it is quite likely that the security interface will not 


perform' the authorization checks covrectly. 


MVS checks authocization· for actions such as opening files by fillst 


checking if there is an ACEE in1 the cuvrent TCB. If it is found, 
authorization checks are perfovmed using the TCB's ACEE. If it is not 
found, MVS continues to search for the appropriate TCB until the ACEE 
associated with the addvess space is found. 


In a now·secured environment where secucity is not implemented, exits 


IOAX006 and IOAX009 can' set the OCTtrSER pavameter, which is the 
reference pavameter foll all programs used as the identity of the current 


wo11king user ID. 
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When using the Online facility under CA-ROSCOE, the IOA security 
interface receives the CA-ROSCOE started task procedure and not the 
user's own user ID. This means that the user needs to sign on twice, once 
under ROSCOE, and a second time under IOA. To avoid this process, a 
special routine is provided (in: the IOA SECUDATA library), called 


IOARROT, which retrieves the user's private ID fromi the co!1I'esponding 
CA-ROSCOE control block and places it in IOA, so that it can be used for 


additional security authorizations. The IOARROT routine should be 
called from within: the IOA Online environment, prior to the standal'd 


IOA security modules. This call should ideally be placed in one of the IOA 


user modules that are invoked, before either IOASE06 or IOASE09 


modules are called. The user modules that support CA-ROSCOE for the 


IOA Online facility communication ave IOAX006T and IOAX009. These 
modules reside in the IOA SECUDATA library. 


User exit IOAX006T should be called when all IOA functions are 
performed under native CA-ROSCOE address space. 


See members DO<DIX006 and DOCIX009 in the IOA SECTIDATA library 
for mo11e details on these exits. 


Note 
When twoienvironments run simultaneously, both user modules 
are placed in the JOA LOAD library; User exit IOAX006T is 
invoked in the online monitor address space as well, but cannot 
locate the required control blocks, as there are no CA-ROSCOE 


control blocks in the online monitor address space. The started 
session abends. It is recommended that these two modules be 
placed in the special JOA LOAD library which is concatenated 
to the STEPLIB in the CA-ROSCOE started task procedure 
before the JOA LOAD library; 


This exit can, be used to control update of the Conditions/Resou:vces file. 
Fo11 ftmther details, I'efer to the IOA Security Guide. 


See member DOCIX007 in the IOA SECUDATA lib11ary for more details 
on this exit. 


This exit controls entry to the IOA Online facility when working with the 
Online monito11 (under CICS, VTAM, IMS/DC, TSO/ROSCOE cross 


memo:ey options, COM~PCETE, and 
1IDMS!T>C). 


User exit IOAX009T should be called when CA-ROSCOE communicates 
with IOA through cross-memory services. AU IOA functions are 
performed in the separate address space, which is the IOA Online 
monito11 address space (OMONl). 


In a non~secured environment where security is not implemented~ exits 


IOAX006 and IOAX009 can set the OCTUSER parameter, which is the 
reference parameter for all programs used as the identity of the current 
working user ID. 


See member D00IX009 in, the IOA SECUDATA library and the 
explanation, on' exit IOAX006 earlier in this section, 
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IOAX012 


IOAX028 


IOAX029 


IOAX031 


IOAX032 


IOAX034 
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This exit can be used to, control or modify the operator commands issued 
by the CTMOPR, CTDOPR, or IOAOPR utilities, or CONTROL-0, or by 
the CONTROI;,-DN CTDNDAY (New Day) p11ocedure or the CONTROL-M 
CONTDAY (New Day) procedu11e. 


See member DOCIX012 in the IOA SECUDATA library for more details 


on1 this exit. 


IOA definition screen exit. This exit is invoked each time the user presses 
the <ENTER> or PF3 key to exit an I0A definition: screen. This exit is 
now relevant for an IOA definition screens (screens 2, 8, R, M, TR, TV, 


TP, BM, BR, OR, and C). 


See member DOCIX028 in the IOA SECtJDATA library fo11 more details 


on this exit. 


IOA Online Sysout/Report Viewing exit. This exit is invoked, for each 
sysout/report line which is to be displayed: on> the user terminal: For 
example, this exit allt>ws translation: of\ unprintable characters. It is 
activated as pan of\ the Online Viewing facility. This exit also provides 
additional 
1features (e.g., malting special data invisible on the report). 


See member D0CIX029 in the IOA SECUDATA library for more details 


on this exit. 


IOA Log exit. This exit is invoked' before a message is written to the IOA 


Log file. The exit may be used to document the message on other files 


(SMF, etc.), or to accumulate statistics for certain messages. 


See member DOCIX031 in the IOA SECUDATA lib11ary for more details 
on this exit. 


This exit is invoked in all IOA panels each time an, IOA user attempts to 


perform an, operation on1 a PDS library or member in a PDS library. This 
exit may deny operations such as accessing a library, listing its directory 
and browsing, editing or saving a member. The exit is invoked when a 
user requests to edit JC::!:. members or documentation data through 
Enterprise Controlstation• The exit checks authorization', and either 
grants or denies the Edit (or Save) request prio11 to the performance of 
these operations by the MVS Gateway for Enterprise Controlstation 


(ECSGATE). 


Receives control for every message issued by the IOA Shout facility. It can 
modify the message text, change its destination, or suppress it. This exit 


can 
1 be activated by either the CONTRC>I.:.-0 monitor, or an IOA 


Functional monitor (used with CONTROIJ-T). 


See member DOCIX034 in the IOA SECt'.JDATA library for more details 


on: this exit. 
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IOA Account Information Extraction exit. This exit is invoked by an IOA 


product whenever account field information is requived •. Exit IOAX.035 


can extract the requested information' from different parts of the account 


field1 depending on' site customization, The exit may be invoked for 
example by CDAM when writing directly to a CDAM file, by CONTROL-D 


when decollating from a spool; or by CONTROL.-T when a job's account 
field is copied to the Media Database. 


See member DOCIX035 in the IOA SECUDATA lib11ary for more details 
onithis exit. 


IOA Access Method (IOAAM) exit. This exit is invoked whenever program 
IOADBF is executed, both as an, independent utility program and, when 
called internally by IOA Access Method 1/0 routines .. This exit can check 
for which function it is being called and either grant 011 deny the request. 


See member DOeIX036 in the IOA SECUDATA library fo11 move 


info11mation on this exit. 


IOA translation1 exit. This exit contains four 256~byte translation tables 
for the IOA online routines. This exit may be used' to translate the· screens 
to any language suppovted at the site in1 addition to upper casing, special 


chwacters sets, and other capabilities. 


See member DOC1X037 in the IOA SECUDATA lib11acy for more 
infovmation on this exit. 


IOA Page Sepavating Exit .. This exit is invoked dulling the creation of a 


CDAM file by a CONTROL.-D decollating mission, or during di11ect writing 
to a CDAM file by a job. The exit can control, page sepavation in a CDAM 


file being created. 


See member DOCIX039 in the IOA SECUDATA library for more details 
on this exit. 


CONTROL-M Exits 


The following CONTROL.-M exits are available: 


CTMXOOl 


CTMX002 


This exit is invoked for every job order which should, be placed in the 
Active Jobs file. The exit is usually used to modify the job production 
parameters .. This exit has an associated, secullity module CTMSEOl. For 
further details,.refer to the IOA Security Guide .. 


See member DOCMXOOOl in the IOA SECUDATA library for move details 
on this exit 


CONTROL-M submission exit. Every line which is submitted by 


CONTROL-M may be modified/deleted/replaced; etc. The exit can' be used 


fo11 adding /*PRIORITY 15 for every production job, etc. This exit has an 
associated secul1ity module CTMSE02: For further details, refer to the 


IOA Security Guide. 


See member DOCMX002 in the IOA SECUDATA libvavy for more details 
on this exit. 
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CTMX003 


CTMX004 


CTMX005 


CTMX008 


CONTROL-M sysout scan exit. After the job finishes executing, every line 
of the job's SYSDATAl is passed to the exit. The main use o£this exit is to 
detect user generated constants in the sysout (such as program DISPLAY 


messages), and to affect the execution, results of the current job 
accordingly. 


See member DOCMX003 in the IOA SECUDATA library for more details 
on this exit. 


This exit allows the user to change the defaults of the CONTROL-M 


scheduling algorithm' by assigning weights to quantitative resou:11ces. In 
this way, CONTROL-M can, fine-tuned to achieve maximum throughput. 


See member DOCMX004 in1the IOA SECtJDATA library for mo11e details 


on this exit. 


This exit is activated under utility CTMJSA which accumulates job 


statistical1data fromithe IOA Log. 


Exit CTMX005 is an1 integral' part of the statistical' data accumulation 
process. It is invoked by utility CTMJSA. The exit is used for the 


following reasons: 


• By default the machine ID (one-character) is automatically derived 
from the SYSID (four-character) and from information, contained in 
CTMP ARM, befo:11e exit CTMX005 is invoked. Exit CTMX005 can 
override the machine ID. 


• It enables the user to add to the job execution statistics, additional 
statistical data which can come from resource other than the IOA Log 


(e.g,, performance monito11s). 


See member DOCMX005 in the IOA SECt!JDATA library for mo11e details 


on 1 this exit. 


This exit is used 
1 to· control1 access to the Active Jobs file. This exit has an 
associated security module CTMSE08. For further details, refer to the 


IOA Security Guide. 


Exit CTMX008 and secu:rii.ty module CTMSE08 are also invoked under the 


MVS Gateway fo11 Enterprise Controlstation, 


See member DOCMX008 in' the IOA SECUDATA library for more details 
on this exit. 


1 SYSDATA is an IOA term used to designate the data in the following three job SYSOUT datasets: 


1. The job log (console messages) 


2. The expanded JCL 


3. The system output messages 
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This exit is used to control1job submission via the Quick Submit facility. 
For example, it can force the use of CONTROL.-M for all, or specified 
production job submissions under TSO. 


See member DOCMXOlO in the IOA SECUDATA library for more details 
on this exit. 


This exit receives control fo11 every message issued by the CONTROL,-M 
Shout facility. It can modify the message text, change its destination, or 
suppress it. It may also be used· for special purposes, such as an interface 
to InfoMan or to Electronic Mail Systems. 


See membe11 DOCMXOll in the IOA SECUDATA library fo11 mo11e details 
on this exit. 


This exit receives control each time a line is displayed by the 


CONTROL-M Online facility in the Job Statistics screen (3.S). The exit 
may modify the line to be displayed~ 


See member DOCMX.013 in' the IOA SECUDATA library for more details 
on this exit. 


This exit is invoked when a request is made to· !SPF-edit a JCL member 
under screen,2 and screen 3 of the Online facility. 


See member DOCMX.014 in the IOA SECUDATA library fo11 more details 
on this exit. 


This exit is invoked when a job has finished executing, and has been 
assigned a CONTROI:.-M finishing status. 


See member DOC:MX015 in the IOA SECUDATA library for mol"e details 
on this exit. 


This exit is invoked when a job has been submitted and needs to be 


tracked, When the dual monitor facility is used, The exit can, be used to 
direct tracking of the job to a specific monitor. 


See member DOC:MX016 in the IOA SECUDATA library for more details 
on this exit. 


The exit receives control1 each time the Tape PuU: list utility ( CTMTAPUL) 


attempts to resolve volumes for each DD statement of the job .. 


See member DOCMX.017 in the IOA SECtJDATA library fo:r more details 
on this exit. 


This exit receives control at certain, points during the process of 
determining the anticipated elapse time of a job. 


See member DOGMX018 in the IOA SECUDATA library for more details 
on this exit. 
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CTMX019 


CMEMExits 


This exit receives control during the CONTROh-M external writer 
initialization· phase. 


See member DOC:MX019 in the IOA SECUDATA library for more details 
on this exit. 


The CONTROh-M Event Manager (CMEM) can also use the following CONTROL-0 exits: 


CTOXOOl 


CTOX002 


Receives control under the Online interface whenever a 
rule 


ORDER/FORCE is performed~ 


See member DOCOXOOl in the IOA SECUDATA library for more details 
on this exit. 


Receives control for every rule before it is loaded to the active 
environment. This exit can be used, to modify rule parameters prior to 
rule loading. 


See member DOCOX002 in the IOA SECUDATA library for mo11e details 


on this exit. 


CONTROL-R Exit 


The following CONTROL-R exit is available: 


CTRXOOl 
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This exit can1 be activated, as part of the CONTRObR step; It allbws better 
control: of the CONTROLR step execution1 and can be used to interface 
with other products (e.g~, checking non-standard datasets). 


This exit can' be used as an interface to· a tape management system in 


011der to extend CONTROL-R's processing. 


When used as an interface with CONTROL-T, this exit receives dataset 
DELETE requests and changes the CONTROL.-T controlled dataset 
status to• Pending-Scratch •. This enables expiration' of the specified dataset 
by the next run of CONTROL-T Retention, Management utility CTTRTM. 


Via customization of this exit, you can, cause CONTROL-T controlled 
datasets to be scratched immediately (i.e., without running utility 
CTTRTM). 


For move information see "CONTROL-R Interface to CONTROL-T" in 
Section 3 of this guide, and "CONTROL-R and Tape Management 
Systems" in the CONTROL-R User Manual. 


See member DOCRXOOl in1 the IOA SECUDATA library for more details 
on this exit. 
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CONTROL-DN Exits 


The following CONTROL-DN exits are available: 


CTDXOOl 


CTDX002 


CTDX003 


CTDX004 


Receives control1 for every mission 1 which should be placed on the Active 
Missions file. This exit is usually used to modify mission p11oduction 
parameters. See member DOCDXOOl in, the IOA SECUDATA library 
and review the IOA Security Guide fon furthen details. 


Printe11 command exit. This exit receives control 
1 at the end of any chunk 
of lines which is sent by CONTROL-D to the spooL This exit can issue 
operator commands to set the printer for the coming chunk (Consult your 


IOA representative before using this exit.) See member DOCDX002 in 
the IOA SECUDATA library for more details about this exit. 


CONTR011-D banner exit. This exit receives control at the beginning and 
end of every print mission or the beginning of a user in the bundle or fo11 


every report in the bundle, or for every chunk in: the bundle. 


This exit produces banner pages at any level and in: any desired format. It 
can also, optionally, produce an: index ofithe reports in a bundle. 


A detailed explanation of how to tailor and use the banner exit appears 
later in this section. 


See member DO©DX003 in 1 the IOA SECVDATA library for more 
details about this exit. 


This exit controls access to the User Reports list files. When an online 
user specifies selection criteria for reports, he/she receives a list of reports 
which he/she is allbwed to see. A user can perform Online viewing and 
other operations only fon reports which are authorized by this exit. (The 
user will see only the decollated portion of any report which he/she is 
allowed to see.) 


When CONTROL-D is installed, a default dummy exit is active .. To 
facilitate installation and product testing, this exit does not enforce any 


secu:rtlty standards. When no security standards are enforced> aU of the 
users may see aU reports under Option U. Once CONTROL-D becomes 
operational, and access to its Online facility is given to many users, it is 
highly recommended to use either the supplied security module 


CTDSE04, or sample user exit CTDX004A. 


Sample exit CTDX004A retrieves security definitions from the Recipient 
Tree. The administrator can identify a recipient (or several recipients) in 
the Recipient Tree with a TSO logon (or logon/CICSNTAM/etc.) user ID. 
These authorizations enable users to see reports under Option U. The 
user IDs to be authorized should be filled in the AUTHORIZE field in the 
definition of each recipient which is authorized for them. Fon more 
information, refer to the Recipient Definition1 screen in Section 2 of the 


CONTROb-D User Manual. When: a user is authorized in the Recipient 
Tree, it means that the TSO (011 CICS, IMS/DC, etc;) user can view all the 
reports of that recipient, and the reports of his descendants in the 
Recipient Tree .. The same TSO user ID (or other environment's sign-on 
ID) can be defined for more than one recipient inthe Recipient Tree. 
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User ID identification ini the AUTHORIZE field, is performed according to 
the following rules: 


• The specified user ID is treated as a prefix of the user ID (if optional 
wish WD2564 is set to YES in member IOADFLTC in1 the IOA 
SECUDATA library). 


• The specified user ID can contain, a number of ? characters. This 
wildcard character indicates any single character. 


Example 


AUTHORIZE A??X willrmatch AIOXOl, but will not match AlXOl. 


Consider the following tree: 


DOD Contracts 


U0108 


AUTH. 11002 


AUTH. U0108 


AUTH. TIO?? 


AUTH. U0109 


Root 


U0106 


AUTH. TIO?? 


AUTH. U0106 


Af> Programmers 
11001 


AUTH. TlOOl 


U=T1003 
U=Tl004 


AUTH. Tl 0?? 
AUTH. Tl O?? 


MIS 


U=T1002 
(JOHN) 


AUIH. TIDD? 


Programmers with TSO user IDs beginning with TlO are responsible fov 
repoxits assigned to the AP department. JOHN is the only programmer 
who writes programs also foxi the DOD contracts section which is 


· classified. JOHN and every pxiogrammer whose user ID starts with TlO 
can view reports 0£ all the members in the programming departments 
and all reports 0£ the AP department. There is one exception: except for 


JOHN (T1002), nomone can look at the DOD contracts section and at 


JOHN's reports. His boss (TSO user TlOOl) can look at JOHN's test 
reports, but not at the DOD p11oduction1 reports. Every user in the AP 
department can look at his/her own reports only. 


The Active User Reports list file also contains entries which describe the 


enfue original1 report. The entries we referenced by a specially reserved 
user name - $SYSDATA. Authorized users can perform Online Viewing of 
the original report (which is now compressed). The authorization· for 
accessing $SYSDATA entries is also controlled by this exit. A user who is 
authorized in the Recipient Definition screen may also· be allowed to view 
$SYSDATA entries if the SYSDATA field (which corresponds to the 


AUTHORIZE field) contains a value Y (Yes). Foxi more information, refer to 
Recipient Definition screen in Section 2 of the CONTROI!rD User Manual. 
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It is strongly recommended to authorize the use 0£ the SYSDATA option 
for a restricted number 0£ operations pe11sonnel, because this option 
allows viewing of oroginal reports. 


The exit also receives control fo11 every function. performed on an1 entry in 
the user list (e.g., update, print, restore, view). It is possible to control who 
is allowed to request a restore, to determine the maximum number of pages 
to be printed to· a remote printe11, etc. The functionality described above can 
also be performed by the security interface module (CTDSE04) .. If CTDSE04 


is installed, the use of sample exit CTDX004A is not necessaey. 


See member DOCDX004 in the IOA SEClIDATA library for more details. 


This exit receives every line to be printed by the CONTROL-D Printers 


Control· monito11 before actual printing takes place. The exit can prevent 
the line from being printed, change its contents, or add more lines to the 
printed output. Two examples 0£ its use: 


Print page sequence numbers from the beginning of the printing mission 
(these numbers can be printed in the bundle index as well). 


The actual printing is suppressed, and the bundle is saved to· a sequential 
file (fo11 file transfer to RJE stations, etc.). See "Printing to a File" in 
Section 4 ofithis guide. 


See member DOC::DX005 in the IOA SEClJDATA library for move 


details about this exit. 


SMF exit. This exit receives control· before each CONTROL-D SMF reco11d 


is written to the SMF datasets. It may suppvess the reco11d, or change it. 
The SMF record written by CONTROL-D is created fo:r~ each combination 
of User/RepomJJob name. Therefo11e, it allows accounting on each level - 
including accounting by report recipient .. The number 0£ pages used is 
accurate (unlike SMF type 6 reco:vds which use app11oximate numbers). 


Note 
SMF type 6 records will be created by JES for the CONTROL-D 


Printers Control monitor when it prints bundles. Therefore; it is 
necessary· not to count the same page twice. This is one of the 
reasons why the CONTROL-D SMF record is not of type 6; The 


SMF record number is· determined by installation parameter 


SMF. For more details· on the format of the record; see the 
sample exit in the JOA SECUDATA library; 


See member DOCDX006 in the IOA SECUDATA lib11ary fov mo:ve 


details about this exit. 


This exit handles the problem of decollating reports which cannot be shown 
on the screen. Many installations use special, cha11acter sets in reports which 


a11e not screen displayable, but which a11e readable when printed. It is 
possible under CONTROL-D to decollate such reports by specifying the 
name of a translation table before the string in the WHEN statement. 


Under this method, the user types what he/she can see, and decollation 
takes place using the actual non-standa11d spool representation. See 
member DOCDX007 in· the IOA SECUDATA library for more details. 
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CTDX008 


CTDX009 


CTDXOlO 


CTDXOU 


CTDX012· 


CTDX013 


CTDX014 


CTDX015 
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This exit is used to control the update of the Active Missions file. See 


member DOCDX008 in the IOA SECUDATA library and review the IOA 
Security Guide. 


Printing job tailoring exit. This exit can modify the contents ofi the 


p:Itintingjob prepwedby the CONTROL-D Print Mission. See Section4 ofi 


this guide for a description of Printing Mission wo11kflow. 


See also member DOCDX009 in the IOA SECUDATA library fo11 mol'e 


details about this exit. 


Backupjobtailoring exit. This exit can modify the contents of the backup 
job prepared by the CONTROL-D Backup• Mission. Refer to Sectiow 4 in 
this guide for a description of Backup Mission workflow. 


See also member DOCDXOlO in the IOA SECUDATA library for more 
details about this exit. 


Restore job tailoring exit. This exit can modify the contents of the resto11e 
job prepared by the CONTROL-D Restore Mission~ Refer to Section4 in 
this guide for a description ofi the Restol'e Mission: workflow. 


See also member DOC]}XOll in the IOA SECUDATA library for more 
details about this exit. 


Activated by utility CTDCA2P. This exit allows the user to change the 
contents ofi the reco11ds which we copied fromi the Active User Report list 
file to the Permanent User Report list file. The exit can also suppress the 
copying of any record. 


See also member DOCDX012 in the IOA SECUDATA library for mol'e 


details about this exit. 


Activated by utility CTDCP2A. This exit allows the user to change the 
contents ofi the records which are copied fromi the Permanent User Report 
list file to· the Active User Report list file. The exit can also suppress the 
copying of any record, 


See also member DOCDX013 in, the IOA SECUDATA library for more 
details about this exit. 


Immediate print request banner exit. Used to print banners on immediate 


p:Itint request from the Online Viewing facility. The exit is similar in 


functionto·exit CTDX003 and is described in further detail:in this guide. 


See also member DOCDX014 in the IOA SECUDATA library for more 
details about this exit. 


This exit receives every line to be printed by an, immediate print request 
(under the Online Viewing facility). The exit can suppress the line, 


change its contents, etc; It is similar in function to exit CTDX005; 


See also member D0CDX015 in, the IOA SECUDATA library for more 
details about this exit. 
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CTDX016 


CTDX017 


CTDX018 


CTDXOi9 


CTDX020 


CTDX021 


CTDX022· 
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This exit receives control1 during report decollation when a search is made 
in1 the Recipient Tree for a synonym which is identical to the recipient 
name found in the report (i.e., when trying to identify the recipient o£the 


page). The exit can determine whether they are equal or not. It is mainly 


used to define synonym ranges. For example:. User BR129 should receive 
all postal1 codes from 10200 to 10399; Refer to Section 7 of the 


CONTR0b-D User Manual for a specific example of the use of this exit. 


See also member DOCDX016 in' the IOA SECtJDATA library for more 
details about this exit. 


This exit receives control' for every message issued by the CONTR0L-D 
Shout facility. It can, modify the message text, change its destination, or 
suppress it. It may also be used for special purposes such as an 
interfacing Electronic Mail systems or InfoMan~ 


See also member DOCDXOl 7 in the IOA SECUDATA library for more 
details about this exit. 


This CDAM user exit is activated when CDAM parameter EXIT= YES is 


specified~ The exit receives control for every line written to the C:IDAM 


file. A description, of the exit can be found in Section 5 of the 


CONTROI;,-D User Manuah 


See also member DOCDX018 in the IOA SECUDATA library for more 
details about this exit. 


This exit is used to control the update of the CONTR0l!.-D/PC Active 
Transfer file. Refer to member DOCDX019 in the IOA SECUDATA 


library and to the IOA Security Guide. 


See also member DOCDX019 in the IOA SECUDATA library for more 
details about this exit. 


This exit is invoked when the Print Plan file is built. It can modify the 
contents of print plan, records before they are written, to the print plan file. 


See also member DOCDX020 in the IOA SECUDATA library for more 
details about this exit. 


This exit is activated befo11e the Recipient Tree is displayed (Screen, T). 
Based on the lib11ary name and Recipient Tree member name, the exit 
determines if the Recipient Tree is to be edited 011 browsed. 


See also member D0CDX021 in the IOA SECUDATA library for more 
details about this exit. 


This exit is invoked during decollation, It can be used to access default 
records in the Active or Permanent User files, to create user and 


SYSDATA records in the Active User file, or to access each page of a 
report that is being decollated. 


See also member DOQDX022 in the IOA SECUDATA library for more 
details about this exit. 
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Replacing CONTROL-D User Exits 


The CONTROL-D monitor supports several user exits: CTDX007, CTDXOlO CTDXOll, and 


CTDX022. 


To load a new copy of an exit without shutting down the CONTROL-D monitor, simply 
enter the exit name using a modify command. Fo11 example: 


F CON'l'ROLD,CTDX007 


After a few seconds, the following message is displayed on the operator console from which 
the modify command was issued. 


CTD126X NEW EXXT CTDX007 LOADED 


In case of an error while loading the new copy of an exit, an appropriate message appears 
on the operator console and the ol'iginal copy of the exit remains active. 


Tailoring CONTROL-D Banner Exit 


General 


There are two Banner exits under CONTROL-D: 


CTDX003 
The deferred print (printing mission) Banner exit. 


CTDX014 
Immediate Print request Banner exit. Used for printing banners on direct 
print requests of Online Viewing users. 


The CONTROL-D Banner exits (CTDX003 and CTDX014) can be tailored fo11 most 


installation requirements without actually coding Assembler instructions (described later 
in this section). 


The foUowing items are discussed in this section: 


• Banner Pages 


• Fo11mat of Banner Pages 


• Printing User Address in Bundle Banner 


• Index Printing Control 


• AFP (AP A) Support 


• XEROX (DJDE) Support 


• Initiating Page Maicks 


• Global Control1 of Printing Chaicacteristics 
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Banner Pages 


The CONTROL-D supplied Banner exit prints different types of banner pages. The Banner 


Pages are defined in the libnary allocated to DD statement DABANNER of the 


CONTROL-D Printens Control' monitor, the Online monitor and of each Online user. A 
sample IOA Banners library is supplied as part of the IOA installation. The following 
banners can be found in the library: 


xxBNDbST 


xxBNDLEN 


xxUSERST 


xxUSEREN 


xxREPSTA 


xxREPEND 


xxUINDXH 


xxUINDXV 


$$0NLSTA 


$$ONLEND 


Bundle Open banner 


Bundle Close banner 


Beginning of a User (Recipient) Reports banner 


End of a User (Recipient) Reports banner 


Start of Report banner 


End of Report banner 


Header of Reports index 


Format of each index line 


Start Banner of immediate print requests 


End banner of immediate print requests 


The prefix of the banner membens beginning with xx is determined by the type of pninter 


used to print the report (Xerox, APA, Siemens, etc.), as follows: 


Type 
Banner Prefix 


REG 
$$ 


LAS 
$$ 


APA 
$1 


XER 
$2 


FOB 
$3 


If a banner member of a specific printer type is not found, the default banner member is 
used (e.g., if $1BNDLST is not found, default member $$BNDLST is used.) 


The type of the printer specified in the CONTROL-D installation parameters (member 


CTDP ARM in the IOA INSTCTD library). 


Format of Banner Pages 


The contents of each banner page is determined by the text which is found in the banner 
member. The following rules apply to printing banner pages: 


The first character of each line can be: 


• Any valid ASA code (1, +,-,etc;). 


• X'5A' - for AFP (Advanced Function Printing). 
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• A line descripto:ri: 


Blank 
Regular size letters 


B 
Big (large)·size letters 


M 
Medium size letters 
s 
Small size letters 


E 
End of banner page 
c 
Comment line 


It is possible to use special variables within the banner page definition. These variables 
will automatically be replaced for each banner printed. The variables are: 


%MISSION%2 


%USER% 


%FATHER% 


%REPORT% 


%CATEGORY%* 


%JOB NAME% 


%JO BID% 


%DATE% 


%TIME% 


%0DATE% 


%PAGES% 


%LINES% 


%DEST% 


%LASTUSER% 


%COPIES% 


%CURRCOP% 


%FROMPAGE% 


%TOPAGE% 


Printing mission name 


User (recipient) name 


Father of the recipient in the tree 


Report name 


Printing Mission categocy 


Name of the job which produced the repol1t 


Job ID (in1JES) which created the repol1t 


Cuuent date (at printing time) 


Current time 


Original scheduling date of the report 


Number of pages (fo11 each· type of banner and, for the index) 


Number oflmes (for each type of banner and for the index) 


Printing (JES) destination 


Last user (used. in END banners) 


Number of copies to be printed (for report banner and for the index) 


Current printing copy (of the copies) (for report banner only) 


From page printed 


Until!page printed 


2 For a Deferred Print Banner only 
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%0BSER%3 


%REMARK% 


%RULER% 


%GR01JP% 


%GLOBALn% 


%IlATAn% 


%ADDRn% 


%LASTADDRn% 


Section 10: Exits 


Name of the user who requested the print 


Decollation remar:k(in Active User list file) 


Name of the ruler being used to print the report. (If no ruler is being 
used, no RULER is printed;) 


Printing GROUP (from the printing mission definition) 


The nth line of member $$GLOBAL (where n can be from 1 to 10) 


The CONTROL-D Banners library contains the member $$GLOBAL. This 
member can contain 1-10 lines of data; When parameter %GLOBALn% is 
specified in the report, the nth line from this member is placed in the 
banner page. 


This pa11ameter can be used to 1distribute NEWS to all report recipients. 


The nth line of a member whose name is identical 
1 to the user name (not 
tothe synonym) in the Recipient Tree. Valid values fo:p n are from 1 to 10. 


The CONTROIL.-D Banners library can contain a member for each report 
recipient. This member may contain 1-10 lines of data. When the 
parameter %DATAn% is specified in the report, the nth line from the 
member of the cuvrent user is placed in the banner page .. CONTROL-D 


does not expect to find such a member for each user. 


A possible use of this parameter is for special distribution instructions for 
that user. See the sample members BMIAMI and UNIDENT. 


The nth address line of the current user (recipient) in the tree. Valid 


values for n are from' 1 to 
1lO. 


The CONTROL-D Recipient Tree can contain address lines which can be 
inserted in 
1 the banner page of this user. Any text can be entered in these 
address lines. A maximum of ten address lines can be specified per user. 


CONTROL-D does not expect to find such lines for each user. 


A common1 use of this pavameter is for the user add11ess (to which the 
bundle should be delivered). 


Note 
For performance reasons, it is recommended to use the 
%ADDRn% variable whenever possible (instead of the %DATAn% 
variable). The %ADDRn% data is always located in memory and 
not in a library. 


Used in the End user banner to print the address of the last user (which 
has already printed) .. This variable is identical to %ADDRn% and is 
supported for backward compatibility. 


3 For immediate print banner only 
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Printing User Address in Bundle Banner 


CONTROL-D can group the repo11ts of several' recipients into one bundle. In such cases, it 
may be desirable to have a specific address assigned to the entire bundle, and to print this 
address on the bundle banner. CONTROL-D does this in the following way: 


The contents of the GROUP field of the printing mission is compared with the Recipient 
Tree. If the GROUP field contains a user name from the tree (not a synonym), the use of 
the variable %ADDRn% in the bundle banner produces the address of this user. 


Eliminate Banners 


If you want to suppress the printing of a certain banner type, simply rename the banner 
member in the Banners lib11ary. You can suppress the printing of User and/or Report 
Banners fo11 all reports of a particular recipient using the Recipient Tree definition. See 
Section 2 of the CONTROI:.,-D User Manual for more details. 


You can also supp11ess the printing of all Banners by a parlicular Print Mission, specify in 
the Print Mission category field the special name NOBANNER. (See Section 4 of the 


CONTROL-D User Manual for more details.) 


See also parameter BANSEQ described' in "Banner Printing Option" later in this section. 


INDEX Printing Control 


The title of the index is retrieved from member $$UINDXH in the BANNERS library. The 
format of each line of index is retrieved from member $$UINDXV in the BANNERS 
libra11y. 


If variable %COPIES% is used in the index, the printed' value is the value befo11e the 
actual print. If the copies count is changed during p11inting (e.g., it was suppressed by a 
user exit), the correction, will not be shown on the index. 


A numbe11 of different pa11ameters can be specified in the banner exits (CTDX003 and 
CTDX014) to control' the p11inting of indexes. These parameters are described as follows: 


GINDEX 


INDEX 
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Whether or not an index of the bundle contents (global index) should be 
printed at the beginning of a pl1inting mission (after the bundle banner 
page). Valid values a11e: 


ON 


OFF 


The global index is pl1inted. 


The global index is not printed~ 


Optionally, it is possible to create a separate index for each user in the 
bundle (a bundle can contain reports for mo11e than, one user). Valid 


values are: 


ON 


OFF 


Each user wiU receive an' index at the beginning of each 
user bundle. However, if parameter INDEX in the 
Recipient Tree is equal to N (or blank), an index will not 
be printed for this user. 


An index will not be produced for each user. However, if 
the INDEX pwameter in the Recipient Tree is equal to Y, 
an index wiU be p:l1inted for this user. 
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LINE CT 


EINDEX 


GEINDEX 
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Specifies the maximum number of index records to be printed on a page. 
If LINECT=O is specified the11e is no limit (Le., any number of records 
may be printed on a page). 


Whether or not an' End User Index should be printed. An End User Index 
is an index printed at the end of a specific user's report bundle that 
indicates which reports were actually printed (i.e., it does not include 


repol1ts that were not printed~ for that use11. Valid values are: 


YES 


N0/blank 


End' User Indexes are to be printed. However, if 
parameter INDEX in the Recipient Tree is equal, to N (or 
blank), an index willlnot be printed for this user. 


End User Indexes a11e not printed, 


Whether 011 not a Global' End, Index should be printed. The Global End 
Index contains an index of all reports that were actually printed in a 
report bundle.Valid values are: 


YES 


NO/blank 


Print a Global End Index. 


Do not print a Global 
1 End Index. 


Banner Printing Options 


Three parameters in the banner exits (CTDX003 and CTDX014) are used to determine 
where, when and how bundle banners are printed: 


BUNSEP 


BAN SEQ 


BANAFP 


Where bundle banners should be printed. Valid, values are: 


YES 


NO 


The bundle start banner, bundle index, and bundle end 
banner are printed to the destination specified in the print 
mission. (See Section 2 of the CONTROL-D User Manual, 
parameter DEST.) 


All other banners, indexes, and reports are printed to the 
destination specified in1 the User Reports screen. (See 
Section,2' ofi the CONTROL-D User Manual, parameter 


DEST.) 


All banners, indexes, and reports are p11inted to the 
destination specified in, the User Repol1ts screen. (See 


parameter DEST in Section12' of the CONTROL-D User 


ManuaL) 


Indicates whether or not CONTROL-D should print banners when 
printing to a sequential file instead of the JES SPOOL. Valid values are: 


YES 


NO 


Print banners when printing to a sequential: file. 


Do not print banners when printing to a sequential file. 


Indicates whether or not to implement PAGEDEF, FORMDEF, and 


Ol!JTPUT statements when printing banners for the report. These 
statements can be included either with the PRINT/CDAM parameters for 
this report, or in the OUTPARMS library. The OUTPARMS library is 
described later in this section, 


IOA Rel. 5.0:0 Administrator Guide 
10-19 


Section 10: Exits 


YES 


NO/blank 


Implement these statements when p:rti.nting banners for 
the relevant report. 


Do not implement these statements when printing 
banners for the relevant repo:rt .. Default. 


OUTP ARM Options 


The O'CJTPARM options provide the ability to override the default printing characteristics 
(specified at decollation time) for all (or some) of the reports and banners to be printed by 


CONTROL-D. To activate this feature add the following parameters to the banner exits 


(CTDX003 and CTDX014): 


Ol!JTPARM 


BANNER 


Whether alli the members in the CONTROL-D OBTPARMS library refer to 
job names or to user IDs.Valid values are: 


JOB 


USER 


The members in the OBTPARMS library refer to job 
names. 


The members in the OUTPARMS library refer to user 
names. 


Whether or not banners should be printed with the characteristics specified 
for reports inthe ONTPARMS library. Valid values are: 


YES 


NO 


Banners willi be printed with these characteristics. 


Banners will not be printed with these characteristics. 


For more information see "Using OUTPARM for 
Global Control, of Printing 


Characteristics" in Section 4 o£this guide. 


AFP (APA) Support 


Section 3 of the CONTROL-D User Manual and Section 4 in this guide explain how 


CONTROL-D supports AFP (APA) printers. When1 you are using AFP (APA) printers, the 
banner exit invokes a special, routine called CTDAP A. 


XEROX (DJDE) Support 


See Section 4 in this guide for information about how CONTROL-D supports XEROX 


(DJDE) printers .. When you are using XEROX printers, the banner exit invokes a special 
routine called CTDDJDE. A source of this routine can be found in the IOA SECUDATA 


library, should you, require additional local adaptations. 


Summary 


By using various line types and special variables, it is possible to tailor the format 0£ 


banner pages for most data centers without an!Y modifying the banner exit itself. However, 
it is also possible to tailor the banner exit. If the supplied banner exit does not fit your 
requirements, you can modify the exit and adapt it for your special requirements. If you do 
so, let us know what changes you made and why. Your modifications may be implemented 
as a standard in a future release. 


Submit the job, and save the member. 
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CONTROL-B Exits 


The following CONTROL-B exits afe available: 


CTBXOOl 


CTBX003• 


CTBX004 


CTBXOOS 


CTBX009 


CTBXOlO 


Receives control for~ every mission order which should be placed in the 
Active Balancing file. For further details, review the IOA Secu:riity Guide. 


See member DOCBXOOl in the IOA SECUDATA library for more details 
about this exit. 


CONTROL,-B database exit. Controls all access (for read/write or update) 
to CONTROb-B database files (group file, basic variable definitions files, 
and variable generation files). 


See member DOG:BX003 in' the IOA SEC"C:JDATA library for more details 
about this exit. 


CONTROL-B Rule Activity file selection exit. This exit controls which 
users will', be allowed to see what CONTROL-B invocations on the Rule 
Activity Display screen. 


See member DOCBX004 in the IOA SECUDATA library for more details 
about this exit. 


This exit is used to control access to the Active Balancing file. For 
example, the exit checks rn a user is authorized to delete a mission using 
the Active Balancing Envi11onment screen. For further details, see the 


IOA Security Guide. 


See member DOC::BXOOS in' the IOA SECtJDATA library for mol'e details 
about this exit. 


This exit receives control' for every message issued by the CONTROl'.,-B 
Shout facility. It can, modify the message text, change its destination,. or 
suppress it. It can also be used fo11 special puvposes, such as an interface 
to InfoMan or to Electronic Mail, Systems. 


See member DOCBX009 in the IOA SECUDATA library for more details 
about this exit. 


Extract user-defined processing exit. This exit is used to,process extracted 
information acco:riding to user-defined specifications du:cing processing of 
a DO EXTRACT statement. For more information on extract processing, 
see the description of the DO EXTRACT statement in Section 5 of the 
CONTROL-Buser manual, and members CTBXOlO and DOCBXOlO in 
the IOA SECUDATA library. 


See member DOCBXOlO in the IOA SECUDATA library for more details 
about this exit. 
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CONTROL-T Exits 


The following CONTROL-T exits are available: 


CTTXOOl 


CTTX002' 


CTTX003 


CTTX004 


CTTX005 


CTTX006 
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Receives control1 for every CONTROL-T rule which is loaded during 


initialization. This exit can be used to modify rule parameters. Security 


module CTTSEOl is associated with this exit. See the IOA Security Guide 
for more information onithis security module. 


See member DOCTXOOl in the IOA SECUDATA library for more details 
about this exit. 


Dynamic stacking exit. Receives control when utility CTTSTK is 
executed, when dynamic stacking for a dataset should be performed~ and 


when a new dataset is added to the Media Database. 


See member DOCTX002 in· the IOA SECUDATA library for more details 
about this exit. 


SVC operation, decision~ Receives control at dataset open and can 
determine the process of this open request. The exit has an associated 
security module CTTSE03. 


See member DOCTX003 in· the IOA SECUDATA library for more details 
about this exit. 


Dynamic definition exit. Receives control when a dataset or volume is to 
be dynamically defined to the Media Database. The exit has an associated 
security module CTTSE04. 


See member DOCTX004 in· the IOA SECUDATA library for more details 
about this exit. 


Abend exit. When CONTROL-T is about to abend a job, this exit receives 
control and determines whether to allow the job to abend or to bypass 


CONTROL-T. 


If you decide to implement this exit, do so with extreme caution. If you 
bypass CONTROL-T, tape protection is disabled for this job; 


See member DOCTX005 in the IOA SECUDATA library for more details 
about this exit. 


Media Database update validation~ Receives control, when. a request to 
update the Media Database is received from the SVC, Online 


environment, or utilities CTTRTM, CTTVTM and CTTEXP. Security 


module CTTSE06 is associated with this exit. 


See member DOCTX006 in the IOA SECUDATA library for more details 
about this exit. 
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IOAX038 
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Cycle processing exit. Receives control whenever utility CTTRTM or 


CTTVTM processes a cyclic dataset. The exit can determine the 
processing parameters. 


See member DOCTX007 in, the IOA SECUDATA library for more details 
about this exit. 


Robotic Tape library interface confirmation exit. Receives control' before a 
request is made to the Robotic Tape library routine to scratch or eject a 
volume .. The exit can allow or reject the request. 


See member DOCTX008 in the IOA SECUDATA library for more details 
about this exit. 


External label, printing. Receives control either from CONTROL-T's 
SVC (via statement D© LABEL) during dataset creation, or from the 


Online environment (screen Tl or TC) by specific request. It can' be used 
to format label1 structure and contents, and/011 specify whether or not to 
print labels. Security module CTTSE09 is associated with this exit. 


See member DO<DTX009 in the IOA SECtJDATA lib11wy for more details 
about this exit. 


Receives control when the Dynamic Dataset Stacking facility scans the 
Media Database fo11 a stackable volume. This exit can, be used to change 
search decisions (i.e., to Reject 011 Accept a volume), or to supply a new 
volume to be used for stacking. 


See member D©CTXOlO in the IOA SECUDATA library for more details 
about this exit. 


Determination of execution environment for IOA functions. This exit can 
be used to specify which Functional monitor is to be used to perform 
which IOA functions. 


See member D081X038 in the IOA SECUDATA library for more details 
about this exit. 


CONTROL-0 Exits 


The following CONTROL-0 exits are available: 


CTOXOOl 


CTOX002 


Receives control under the Online interface whenever a 
rule 


ORDER/FORCE is performed. 


See member D©COXOOl in' the IOA SECUDATA library for more details 
about this exit. 


Receives control1 for every rule before it is loaded to the active 
environment. This exit can, be used to modify rule parameters prior to 
rule loading. 


See member D0COX002 in the IOA SECUDATA library for more details 
about this exit. 
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CTOX003 


CTOX004 


CTOX008 
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Receives control befo11e execution of each DO KSLfl'SO statement. This 
exit can be used to modify specific requests. 


See member DOCOX003 in the IOA SECUDATA library for more details 
about this exit. 


Receives control each time a user enters an Automation: Options screen or 
attempts to. perform an action in an Automation Options screen. 


See member DOCOX004 in the IOA SEGNDATA library for more details 
about this exit. 


Receives control each time a user enters the Rule Status screen or 
attempts to·performoperations onthe Rule Status screen. 


See member DOCOX008 in the IOA SECtJDATA library for more details 
about this exit. 
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JOA Application Program Names 
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Appendix A: IOA Application Program Names 


Appendix A: IOA Application Program Names 


The following application program names can be found on IOA product tapes: 


CTBIUTI' 
CONTROL-B Utilities screen 


CTBTABS 
CONTROL-B Active Balancing Environment screen 


CTBTBAL 


CTBTDAT 


CTBTJBL 


CTBTRLB 


CTDIUTI 


CTDTAMS 


CTDTATF 


CTDTDPC 


CTDTMIS 


CTDTREP 


CTE>TUSR 


CTDTUTR 


CTMTDTM 


CTMTNRS 


CTMTRES 


CTMTSCH 


CTMTRCM 


CTMTSTA 


CTMTTSO 


CTOTARF 


CTOTMSC 


CTOTOMP 


CTOTALO 


CTOTAOP 


CTTTRLD 


CTTTPLD 


CTTTVLD 


CTTTINQ 


CTTTKIN 


IOATLOG 


IOATMNU 


CONTROL-B Balancing Mission Definition screen 


CONTROI'.r-B Database Variables Definition screen 


CONTROL-B Rule Activity screen 


CONTROI:r-B Rule Definition screen 


CONTROL-D Utilities screen 


CONTROL-D Active Missions screen 


CONTROL-D/PC File Transfer Status screen 


CONTROL-D file Transfer screen 


CONTROL-DN Migration/Printing/Backup/Restore Mission 
Definition screen 


CONTROL-D Report Decollating/Indexing Definition screen 


CONTROI:r-D User Repovts screen (Online Report Viewing) 


CONTROL-D Recipient Tree screen 


IOA Calendar screen 


IOA Manual Conditions screen 


IOA Condition Resources screen 


CONTROL-M Online Scheduling 


CMEM Definition facility 


CONTROL-M Status screen 


IOA TSO Command Processor screen 


CONTROL-0 Rule Status screen 


CONTROL-0 Message Statistics screen 


CONTROL-0 Rule Definition screen 


CONTROL-0 Automation, Log 


CONTROL-0 Automation, Options 


CONTROL-T Rule Definition screen 


CONTROL-T Pool, Definition· screen 


CONTROL-T Vault Definition, screen 


CONTROL-T Inquire/Update screen 


CONTROL-T External Volume Check~Jn, screen 


IOA Log screen, 


IOA Primary Option, menu 
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Appendix B: Dataset Formatting Utilities for 


IOA Products 


The following JCL members can be used to create and format the IOA and CONTROL 


products' datasets:· 


1. IOA (in IOA INSTALL Library) 


FORMDRES 
IOA Mirro11 (Dual) Conditions/Resources file 


FORMIOA 


FORMLOG 


FORMNRS 


FORMRES 


Formats all IOA files 


IOALog 


IOA Manual Conditions file 


IOA Conditions/Resources file 


2. CONTROL-M (in IOA INSTCTM Library) 


FORMCKP 


FORMCTM 


FORMDCKP 


FORMG2M 


FORMGRF 


FORMStJBl 


FORMStJB2 


FORMSTT 


CONTROL-M Active Jobs file and its backup file 


Formats all CONTROL-M files 


CONTROL-M Mirror (Dual) Active Jobs file 


CONTROL-M Gateway Communications file 


CONTROL-M Dependencies file 


CONTROL-M CMEM file 


CONTROL-M CMEM file 


CONTROL-M Job Execution Statistics file 


3. CONTROL-D (in IOA INSTCTD Library) 


CONTROL-D Active Missions file and its backup file 


CONTROL-D MF/AS400 Transfer file 


CONTROL-D Active Transfer file fo11 CONTROL-D/PC 


CONTROL-D Bundle Tracking file 


C:r~eates the IOA user catalog for the CDAM files 


CONTROL-D Communication, file 


Formats all CONTROL-D files 


FORMAMF 


FORMAS4 


FORMATF 


FORMBTR 


FORMCAT 


FORMCOM 


FORMCTD 


FORMPGC 


FORMUFl 


FORMUF2 


The file that saves the number of pages prepared for all print missions 


Allocates and formats all CONTROL-D User files 


Reformats all CONTROL-D User files without reallocating 
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4. CONTROL-V (in IOA INSTCTV library) 


FORMCTV 
Allocates and formats CONTROL-V Migration, file 


FORMUF3 
Allocates and formats CONTROL-V Migrated, User Reports file 


FORMUF4 
Formats CONTROL--V Migrated User Reports file without reallocating 


5. CONTROL-0 (in the IOA INSTCTO library) 


DEFGLOB 
Allbcates and formats the Global Variables libvary 


DEFSTAT 
Allocates and formats the Message Statistics file 


DEF ALO 
Allocates and fo11mats the Automation Log file 


6. CONTROL-T (in IOA INSTCTT library) 


CTTCMDB 
Allocates and fo11mats CONTROL-T Media Database (MDB) file 


CTTCSTK 


CTTCTRC 


Allocates and fo11mats CONTROL-T Stacking Statistics file 


Allocates and fo11mats CONTROL-T Trace file 


7. Enterprise Controlstation (in IOA INSTECS library) 


FORMM2G 
Allocates and formats CONTROL-M/ECSGATE Communications file 
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Appendix C: Modifying IOA Online Facility 
Commands 


Every screen 0£ the IOA Online facility has a set 0£ valid commands which are suppo11ted 


under it .. It is possible to change the names of these commands or to create synonyms. The 
commands reside in the IOA PARM lib11ary in members with the following naming 
conventions: 


The active commands member. 
TxxxCMDl 


TxxxCMDD 
Debugging aid member - contains additional commands for p11oblem 


analysis. 


xxx is the screen1 identifier. For a detailed description 0£ how to modify a command 
member, refer to the Section 2 of this guide. 


A command member is composed 0£ one header line, and: any number of command1 lines. 
The number at the left 0£ the header line is the total number of command lines in 
1 the 
member. It must be updated when lines from' the command member are added, 011 deleted. 


The structure of the command line is as follows: 


Column 
Description 


1-8 
The command name. 


25-28 
Reserved hexadecimal (unp11intable) value. Do not change it. 


A description of the command. 


69-72 
Reserved hexadecimal (unprintable) value - the internal command 
member. Do not change it. 


It is possible to change the command name and/011 the description• To add a synonym, 
duplicate the command line, modify the command name on' the duplicated line, and modify 
the command line counter at the le£t side of the header line. 


Modifying IOA Online Facility PFKey Definitions 


Every screen' of the IOA Online facility has a set of PFKeys with, pre-assigned, commands. 
It is possible to change these PFKey definitions. The PFKey assignments reside in the IOA 
PARMCMD lib11ary in members with the·following naming conventions:· 


TxxxPFl 
xxx is the screen identifier. 


A PFKey member is composed of one header line, and any number of PFKey definition 
lines. 


The structure of the PKFey definition line is as follows: 


Column 


1-8 


9~22 


Description 


The PFKey or <ENTER>. 


The command assigned to the PFKey. 


At least one PFKey/Enter key must be defined as the <ENTER> command. 
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Appendix D: Logical Field Names for the 
CONTROL-T Repository 


The tables in the following pages list fields that can be: 


• Specified in' utility INCLUDE/EXCLUDE statements to determine which records a11e 
pvocessed when the utility runs .. 


• For a complete explanation 0£ INCLUDE/EXCLUDE statements, see "Recovd Selection 
Logic (INCLUDE/EXCLUDE Statements)" at the beginning of the CONTROL-T utility 
descriptions in Section' 9 of this guide. 


• Manually updated in 
1the Media Database via utility CTTMUP. 


• Included in utility-generated reports. 


The following pages contain a series of tables which specify field names according to record 
type. Each table contains the following data fo11 each field: 


External Name 


Valid Values 


Description' 


Internal Name 


Field name as specified by the user. 


Either of two types of data: 


Keyword 
value 


Value type 


Specific valid values. Shown• in1 uppercase (e.g., CYCLE, 
DATE, JCL). Non~trivial values are accompanied by a 
description' in· the Description column 0£ the table. 


Shown in1 lowercase (e.g., char, integer, date). These ave 


described, below. If relevant, the maximum· length of the 
value is displayed,in 
1parentheses next to the value type. 


Bvief description of the field. This column also· contains a description, 
of any specific values specified in, the Valid Values column' 


Name used in the macro to· reference the field. 


Below is a brief description 0£ the value types that can be specified in the Valid Values column: 


char 


hex 


date 


%CBAY 


%PDAY 


%NDAY 


%PWEEK 


%NWEEK 


%PMONTH 


%NMONTH: 


Free character fo11mat. Maximum length indicated in, parentheses. 


Hexadecimal· character format (valid characters are 0-9, A-F). 
Maximum length indicated 1 in, pa11entheses. 


Valid' formats a11e:.yymmdd 011 yyyymmdd. The following keywords are 
also valid: 


Current day (today). 


Previous day (yesterday). 


Next day (tomorrow). 


Previous week. 


Next week. 


Previous month (30 days). 


Next month (30 days). 
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time 


julian date 


integer 


date/integer 


Valid format is hhmmss. 


Valid: formats are yyddd or yyyyddd. Special "dates" (e.g., 98000, 
99000) are also supported~ 


Numeric·value. 


Either a date value or an' integer value can be specified (as described 
above). Date values should be p11efixed by D (e.g,, format Dyyyymmdd). 
Integer values should be p11efixed by I (e.g~, 135). By default (Le.,. if no 
prefix is specified), the value is assumed to be a date. 


Table 1: Keywords to Be Used With Dataset Type Records 


ACCOUNT 
char 
(50) 
Job1s accounting info. 
DDSACCT 


BLKSIZE 
integer 
Dataset's block size 
DDSBLK 


BLOCKCT 
integer 
Block count 
DDSBLKC 


CRECC 
char 
(4) 
Condition code of creating step' 
DDSCCC 


CRECPlJ 
char 
(4) 
CPU in which dataset was 
DDSCCPlJ 


created 


CREDDN 
char 
(8) 
Creating DD name 
DDSCDDN 


CREDT 
date 
Creation date 
DDSCDT 


CREJBN 
char 
(8) 
Creatingjob name 
DDSCJBN 


CREJOBID 
char 
(8) 
Creating job ID (fo11mat 
DDSCJID 
JOBxxxxx) 


CREPGM 
char 
(8) 
Creating program name 
DDSCPGM 


CRESTEP 
char 
(8) 
Creating step name 
DDSCSTP 


CRETM 
time 
Creation time 
DDSCTM 


CREUAD 
hex 
(4) 
Unit address on which the 
DDSCUAD 


dataset was created 


CREUSER 
char 
(8) 
User ID which, created the 
DBSCUSER 


dataset 


DCHANGED 
date 
Last change date 
DDSMDT 


DC HAN Ci ET 
time 
Last change time 
DDSMTM 


DCHANGEU 
char 
(8) 
Last user ID that changed the 
DDSLUSER 


entry 
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DENSITY 
BPl200 
BPI556 
Density of the data on the 
DDSDEN 
BPl800 
volume 


BPl1600 BPl6250' 
BPl38000 


BPI38KE 


BPI3590 


DSENDFET 
integer 
Dataset ending footage on' the 
DDSEFTG 


volume 


DSEXCP 
integer 
EXCP count since dataset was 
DDSEXCP# 


created 


DSEXPDT 
date/integer 
Dataset's expiration date, 
DDSEXPDl 


number of cycles or number of 
days according to DSEXPTYP 


DSEXPTYP 
Dataset's expiration type: 
DBSEXPTl 


CYCLE 
Number of cycles 


DATE 
Actual date 


EDM 
EDM controlled 
u 


LAC CS 
Number 0£ days since last 
accessed 


CATALOG 
MVS Catalog Control 


PERM 
Permanent dataset 


VLTRET 
Controlled by vaulting 


SMS 
Controlled by SMS Management 


Class 


DSFEET 
integer 
Footage occupied by the dataset 
DDSFEET 


DSFLAGS 
Dataset flag byte:· 
DDSFLGl 


DISPMOD 
Dataset opened with DISP=MOD 


DYNDEF 
Dataset dynamically defined 


RECREATE 
Dataset recreated 


MANUPDAT 
Dataset manually updated 
(Online/Utility CTTMUP) 


JCLRETPD 
RETPD specified in the JCL for 
the dataset 


DELRTM 
Dataset marked as to be deleted 
byCTTRTM 
u 
DSRSTRT 
Dataset processed· under M¥S 
RESTART 
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DSLABEL 
integer 
Dataset label number 
DBSLBI:.NM 


DSNAME 
char 
(44) 
Dataset name 
DDSDSN 


DSSTAT 
Dataset's status: 
Dl1>SSTAT 


DACTIVE 
Active dataset 


DINC:JSE 
In-use dataset 


DPENDSCR 
Pending scratch dataset 


DSCRATCH 
Scratched dataset 


DSTACKED 
Stacked dataset 


DEDM 
EDM controlled dataset 


DAB END 
Closed under abend dataset 


DNSTK 
Unstackable dataset 


DSt!JSECT 
integer 
Dataset's usage count 
DDSUSED# 


DSVOI:.SER 
char 
(6) 
Dataset's first volume 
DilSVOLSR 


Dl!JSRDATA 
char 
(20) 
User data 
DDSUSER2 


JCLEXPDT 
Julian date 
JCL EXPDT value 
DDSJEXPD 
u 


LASTACCS 
C,R,W 
Type oflast access (create, read, 
DDSLACS 


write) 


LRECL 
integer 
Dataset's logical record length 
DDSRECL 


READ CC 
char 
(44) 
Condition code of the last step· 
Dl1>SRCC 


which read the dataset 


READ CPU 
char 
(4) 
CPU in which dataset was last 
DDSRCPU 


read 


READDBN 
char 
(8) 
Last read DD name 
DDSRDDN 


READDT 
date 
Last read date 
DDSRDT 


READJBN 
char 
(8) 
Name of the last job which read 
DDSRJBN 


the dataset 


READPGM 
char 
(8) 
Name of last program which 
DDSRPGM 


read the dataset 


READSTEP 
char 
(8) 
Name of the last step.which 
DDSRSTP 


read the dataset 


READ TM 
time 
Last read time 
DDSRTM 


READl!JAD 
hex 
(4) 
Unit address on which the 
DDSRUAD 


dataset was last read 
u 
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REC FM 
U, F, FB, FBA, 
Dataset's record format 
DDS REC FM 
FBM, FBS, V, VB, 
VS, VBA, VBM, 
VBS,D 


RTNFROM 
Dataset Retention origin: 
DDSRTORG 


DEFAULT 
From CTTPARM 


JCL 
From,JC::L 


RULE 
From CONTROL-T rules 


SMS 
From SMS Management Class 


From SMS default 


SMSDFLT 


From' SMS limit 


SMSLIMIT 
From SMS J(J;L 
SMSJCL 


SMSMC 
char 
(8) 
SMS Management Class 
DIJ>SSMCL 


TRTCH 
COMP, NOCOMP 
Indication of whether or not the 
DDSTRTCH 
u 


data is compressed (e.g . .IDRC) 


VOL.SNUM 
integer 
Number of volumes on which 
DDSVOLS# 


the dataset resides (multi- 
volume dataset) 


WRITE CCC 
char 
(4) 
Condition code of the last step 
DDSWCC 


which wrote to the dataset 


WRITECPtJ 
char 
(4) 
CPt:J in which the dataset was 
DDSWCPU 


last written 


WRITEDDN 
char 
(8) 
Last write DD name 
DDSWDBN 


WRITEDT 
date 
Last write date 
DDSWDT 


WRITEJBN 
char 
(8) 
Name of the last job to write to 
DDSWJBN 


the dataset 


WRITEPGM 
char 
(8) 
Name of last program which 
DDSWPGM 


wrote to the dataset 


WRITESTP 
char 
(8) 
Name of the last step which 
DDSWSTP 


wrote to the dataset 


WRITETM 
time 
Last write time 
DnSWTM 


WRITEUAD 
hex 
(4) 
Unit address on which the 
DIDSWUAD 


dataset was last written 


u 
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Table 2: Keywords to Be Used With Volume Type Records 


ACTIVEDS 
integer 
Number of active datasets 
DVLACTD# 


BOXID 
char 
(6) 
Box ID 
DVLBOXID 


CHKINDT 
date 
Check-in date 
DVLFCDT 


CLNCOUNT 
integer 
Volume's Clean Count 
DVLCLN# 


EXPDSNUM 
integer 
Expiration dataset number 
DVLEXPDS 


EXPRTRN 
date 
Expected return date from out 
DVLRTRN 
location 


FIRSTVOL. 
char 
(6) 
First volser for multi-volume 
DVLFIRST 


chains 


IOERPRM 
integer 
Read permanent errors count 
DVLRPER 


IOERPRMC 
integer 
Read' permanent errors count 
DVLRPERC 


since last clean 


IOERTMP 
integer 
Read temporary errors count 
DVLRTER 


IOERTMPC 
integer 
Read temporary erro11s count 
DVLRTERC 
\_) 


since last clean 


IOEWPRM 
integer 
Write permanent errors count 
DVLWPER 


IOEWPRMC 
integer 
Write permanent errors count 
DVLWPERC 


since last clean 


IOEWTMP 
integer 
Write temporary errors count 
DVLWTER 


IOEWTMPC 
integer 
Write temporary errors count 
DVLWTERC 


since last clean 


LACCDT 
date 
Date of last volume access 
DVLADT 


LACCJBN 
ch av 
(8) 
Name oflastjob,which accessed 
DVLJBN 
the volume 


LACCTM 
time 
Time oflast volume access 
DVLATM 


LBLNUM 
integer 
Last label number on the 
DVLLBLNM 
volume 


LBLTYP 
SL,NL,NSL, 
Label type 
DVLLTYP 
SUL, AL, AUL, 
BLP 


LCLNDT 
date 
Last clean, date 
DVLCLN 


LDSFEET 
integer 
Last dataset on, volume footage 
DVLLDFTG 


<..J 
LOCATION 
char 
(8) 
Current location, of the volume 
DVLCODE 
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LOCSEQ 
integer 
Vault sequence number 
DVLVTSQ 


MEDIA 
char 
(8) 
Volume's media type 
DVLMEDIA 


MOVEDATE 
date 
Last move date 
DVLMVDT 


NEXTVOL 
char 
(6) 
Next volser for multi-volume 
DVLNEXT 
chains 


PREVVOI!. 
char 
(6) 
Previous volser for multi- 
DVLPREV 


volume chains 


REC FROM 
char 
(8) 
Vault name from which the 
DVLVLTRC 


volume recalled 


RECVLNUM 
integer 
Vault number (in pattern) from 
DVLVLTI 


which the volume recalled 


REMFEET 
integer 
Available footage of the volume 
DVLRFEET 


RETVLTDT 
date 
Retum to vault date 
DVLVRTRN 


SCRDT 
date 
Last volume scratch date 
DVLSCRDT 


SLNAME 
char 
(6) 
Volume's SL-NAME 
DVLSLNAME 


u 


SLOTNUM 
integer 
Vault slot number 
DVLVSLOT 


UNITNAME 
char 
(8) 
Volume's unit name 
DVLUNAM 


USERDATA 
char 
(20) 
User data 
DVLUSER2 


VAULT 
char 
(8) 
Vault name in vault info 
DVLVLTNM 


VCHANGED 
date 
Last change date 
DVLMDT 


VCHANGET 
time 
Last change time 
DVLMTM 


VCHANGEU 
char 
(8) 
Last user ID that changed the 
DVLUSER 


entry 


VDENSITY 
BPI200· 
Density of the data on the 
DVLDEN 
BPI556 
volume 


BPI800' 


BPI'1600 
BPI6250 


BPI38000 
BPI38KE 
BPI'3590 


VENDOR 
char 
(8) 
Name of vendor who 
DVLVNDOR 


manufactured the volume 


VLTDSNUM 
integer 
Vaulting dataset number 
DVLVLTDS 


VLTENTDT 
date 
Entry date to the vault 
DVLVENDT 


VLTENTNM 
integer 
Number of vault entries for the 
DVLVLTT 
, u 
volume 
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VLTEXPDT 
date/integer 
Vault expiration, date, number 
DVLVXPDl 


of cycles or number of days 


VLTEXTYP 
Vault expiration: type: 
DVLVXPTl 


VCYC 
Number of cycles 


VDATE 
Actual date (in yyyymmdd 
format) 
VLACC 
Number of days since last 
accessed 


VCAT 
MVS Catalog Control 


VP ERM 
Permanent 


VEXP 
Until volume expiration 


VDAYS 
Number of days in vault 


VLTPREFL 
integer 
Vaulting dataset name prefix 
DVLPRFLN 
length 


VOLEDMID 
char 
(4) 
EDM-ID for EDM controlled 
DVLEDMID 
volumes 
' 
: 
\ 


VOI:.EXCP 
integer 
EXCP count since last scratched 
DVLEXCP# 
\_) 


VOLEXPDT 
date 
Expiration date 
DVLEXPD 


VOLEXPTY 
DATE, PERM, 
Expir:ation date type 
DVLEXPT 
UNKNOWN 


VOLFEET 
integer 
Volume's used footage 
DVLFEET 


VOI:.FLAGS 
Additional volume status flags: 
DVLFLGl 


RETURNVL 
Volume returned from vault 


DYNDEF 
Volume dynamically defined 


MANUPDAT 
Volume manually updated 


(Online/tltility CTTMUP) 


VLRSTRT 
Volume processed under MVS 


RESTART 


EXTDEL 
Volume will be deleted when' 
expired 


MANVLT 
Volume manually moved to 
vault 


SNGLVOI!, 
Single volume (out of multi- 
volume group) in 


VAULT/RECALL 
u 
INROBC>T 
Volume resides in a robot 


D-8 
IOA Rel. 5.0.0 Administrator Guide 


u 


Appendix D: Logical Field Names for the CONTROL-T Repository 


VOLFI:.AG2· 


VOI;.IND 


VOLODESC 


VOI:.OWNER 


VOI!..SEQ 


VOI!..SER 


VOLSTAT 


VOLUSECT 


VT RT CH 


VLTBYBOX 


PVLT 


PENDVLT 


RECALL 


H@LD 


NOST ACK 


INUSE 


char 
(20) 


char 
(8) 


integer 


char 
(6) 


ACTIVE 


SCRATCH 


PENDSCR 


OUT 


VAULTED 


EXTERNAL 


EDM 


DELETED 


integer 


COMP 
NOCOMP 
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Additional status flag: 


Volume can be vaulted by boxes 


Additional volume status 
indications: 


Potential vault 


Pending vault 


Recalled back from a vault 


Hold before return to vault 


Stacked datasets not accepted 


Volume is in•use 


Volume's description 


Volume's owner 


Volume sequence number 


Volume's serial number 


Status of volume: 


Active 


Scratch 


Pending scratch 


Out of library (but not vaulted) 


Vaulted 


External volume 


EDM controlled volume 


Deleted volume 


DVLFLG2 


DVLSTA2 


DVLDESC 


DVLOWNR 


DVLVSEQ 


DVLVOLSR 


DVLSTAT 


Volume usage count from last 
DVLUSED# 


scratch 


Indicates whether or not data is 
DVLTRTCH 
compressed (e.g.,.IDRC) 
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Table 3: Keywords to Be Used With Stacking Type Records 
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SDENSITY 
BPl200 
Density of the data on, the 
STlJDDEN 
BPI556 
volume 


BPI800 
BPI1600 
BPI6250 
BPl'38000 


BP138KE 


BPl3590 


STKBLKCT 
integer 
Dataset's block count 
STUDBLC 


STKBLKSZ 
integer 
Dataset's block sirz:e 
STUDBLKS 


STKCOMPF 
integer 
Stacking compression factor 
STUDCMPF 


STKDATE 
date 
Creation, date 
STUD DTE 


STKDSN 
char 
(44) 
Dataset name fo:ri which 
STUDDSN 


stacking statistics are kept 


STKIND 
NOSTK 
Indication whether or not the 
STUFLAGl 
\ 
dataset can1 be stacked 
<_J 


STKJBN 
char 
(8) 
Job name by which stacking 
STUDJOB 


statistics are kept for the 
dataset 


STKPGM 
char 
(8) 
Name o£the program which 
STUDPGM 


created the stacked dataset 


STKTIME 
time 
Creation time 
STUDTME 


STKUNIT 
hex 
(4) 
Unit name used to create the 
STUD UNIT 


dataset 


STKVOLl 
char 
(6) 
First volume in the group· ofi 
STUD VOL 


volumes 


STRTCH 
COMP 
Indicates whether or not data STUDRTCH 
NOCOMP 
is compressed (e.g. IDRC) 
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Table 4: Keywords to Be Used With Trace Type Records 


CPUID 
char 
(4) 
CPU-ID 
ARCCPUID 


DATE 
date 
Date 
ARC DATE 


ENV 
DLD5 
CTTDLD utility 
ARC ID ENT 


EDM 
External Data Manager 


MVP 
Manual update utility 


(CTTMUP) 


ONL 
Online facility 


ONLC 
External Volume Check-In, 


(TC Screen) 


RTM 
Retention management 
utility (CTTRTM). 


STK 
Dynamic Stacking Facility 


SVCT 
Real~time environment 
u 
UTL 
Volume expiration utility 


VTM 
Vault management utility 


(CTTVTM) 


$RCV 
Utility CTTRCV Recover 
Media Database using Trace 
file 


FUNCTION 
ADD, DELETE, 
Activity type 
ARCTYPE 
CNANGE 


JOB ID 
char 
(8) 
Job ID (fovmat JOBxxxxx) 
ARCJOBlD 


TIME 
time 
Time 
ARC TIME 


USER ID 
char 
(8) 
User ID/Job:name 
ARCUSRID 


u 
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Table 5: Keywords to Be Used With Trace Data 


RECTYPE 
V,D 
MDB Record Type 
DVLRTYPE, 
DDSRTYPE 


VOLSER 
char 
(6) 
Volume serial number 
DVLVOLSR 


DSNAME 
char 
(44) 
Dataset name 
DDSDSN 


RBA 
hex 
(6) 
Record's RBA 
DVLRBA, 


DDSRBA 


. 
\ 
\J 


, 
\ 
v 
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Appendix E: IOA Online Options 
Cross-Reference 


IOA 


1 
IC>A Primary IOATMNU 
$$MNU 
TMNUPF3 
Option Menu 


4 
10A 
CTMTRES 
CTMSRES 
TRESPFl 


Conditions/ 


Resources 


5 
IOALOGfile 10ATLOG 
$$LOG 
TLOGPFl 


6 
TSO-TSO 
CTMTTSO 
CTMSTSO 
TTSOPFl 


command 
6* 
!SPF 
I0AIUTI 
Utilities 


7 
I0AManual 
CTMTNRS 
CTMSNRS 
TNRSPFl 


Conditions 


.8 
10A 
CTMTDTM 
CTMSDTM 
TDTMPFl 


Calendar 
Facility 
(Entry Panel) 


8.D 
List of 
CTMTDTM 
CTMSDTD 
TDTMPFl 
Calendars 


8.D 
List of Years 
CTMTDTM 
CTMSDTD 
TDTMPF3 


8.Y 
Calendar 
CTMTYER 
CTMSYER 
TDTMPF4 
Definition 


TMNUCMD3 


TMNUCMD3 


TLOGCMDl 


TTSOCMDl 


TNRSCMDl 


TDTMCMDl 


TDTMCMDl 


TDTMCMDl 


TDTMCMDl 


* A separate ISPF panel cross-reference appears later in 
1 this section~ 
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CTMHMNU* 


CTMHLOG 


CTMHTSO 


CTMHNRS 


CTMHDTM 


CTMHDT2 


CTMHDT3 


CTMHYER 


E-1 


Appendix E: IOA Online Options Cross-Reference 


CONTROL-M 


2 
Scheduling 
CTMTSCH 
CTMSSCH 
TSCHPFl 
TSCHGMDl 
CTMHSCH 


Definition 
Entry Panel 


2 
Table List 
CTMTSCH 
CTMSDIR 
TSCHPF3 
TSCHC::MDl 
CTMHSC2 


2 
Job List 
CTMTSCH 
CTMSDIR 
TSCHPF3 
TSCHCMDl 
CTMHSC3 


2.0 
Job Order 
CTMTJOB 
CTMSJOB· 
TJOBPFl 
TJOBCMDl 
CTMHJoa· 


Messages 


2.G 
Graphic Job 
CTMRFLW 
CTMSFLW 
TGRFPFl 
TGRFCMDl 
CTMHGRF 


Flow 


2.P 
Job 
CTMTRPL 
$$RPL 
TRPLPFl 
TRPLCMDl 
CTMHRPL 
Scheduling 
Plan 


2 
Job 
CTMTGZM 
CTMSGZM 
TZUMCMDl TZUMCMDl CTMHZUM 


Definition 
Plan 


2 
Group 
CTMTGZM 
CTMSGZM 
TGZMPFl 
TGZMCMDl CTMHGZM 


Definition 


Screen 


3 
Active 
CTMTSTA 
CTMSSTA 
TSTAPFl 
TSTAGMDl 
CTMHSTA 


Environment 
. 
\ 


3.Z 
Job Zoom 
CTMTSZM 
CTMSSZM 
TSZMPFl 
TSZMCMDl 
CTMHSZM 
'v 


Screen 


3.N 
Job's NET 
CTMTNET 
$$NET 
TNETPFl 
TNETCMDl 
CTMHNET 


Display 


3.? 
Job's WHY 
CTMTNET 
$$NET 
TNETPFl 
TNETCMDl 
CTMHNET 


Screen 


3.S 
Job's 
CT MTV ST 
CTMTVST 
TVSTPFl 
TVSTCMDl 
CTMHVST 


Statistics 


3.V 
Job's View 
CTMTSYV 
$$AJH 
TAJHPFl 
TAJHCMDl 
CTMHAJH 
SYS OUT 
$$AJA 


3.V.S 
Job's SYSOUT IOATOLV 
CTMSSYV 
TSYVPFl 
TSYVCMDl 
CTMHSYV 


Viewing 


3.VIEW Job's GROUP CTMTVEW 
CTMSVEW 
TVEWPFl 
TVEWCMDl CTMHVEW 
DISPLAY 


c 
CMEMEntry CTMTRCM 
CTMSRCM 
TRCMPFl 
TRCMCMDl CTMHRCM 
Panel 


c 
Tables/Rules CTMTRCM 
CTMSRDR 
TRCMPF3 
TRCMCMDl CTMHCM2 


of Library 
c 
Rules of 
CTMTRCM 
CTMSRDR 
TRCMPF3 
TRCMCMDl CTMHCM3 


Tables in 
Library 
c 
Rule 
CTOTRUL 
CTOSRUL. 
TRULPFl 
TRULCMDl 
CTMHRUL 


Definition 


Screen 
u 
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u 
CONTROL-D 


A 
Mission 
CTDTAMS 
CTDSAMS 
TAMSPFl 
TAMSCMDl 
CTDHAMS 
Status 
Screen 


A.Z 
Zoom 
CTDTDEC 
CTDSDEC 
TDECPFl 
TDECCMDl 
CTDHDEC 


Decollating 
Mission 
Definition 


Screen 


A.Z 
Zoom 
CTDTAPR 
CTDSAPR 
TAPRPFl 
TAPRCMDl 
CTDHAPR 


Printing 
Mission 
Definition 


Screen 


A.Z 
Zoom Restore CTDTARS 
CTDSARS 
TARSPFl 
TARSCMDl 
CTDHARS 
Mission 
Definition 


Screen 


A.Z 
Zoom Backup CTDTABK 
CTDSABK 
TABKPFl 
TABKCMDl 
CTDHABK 
Mission 
Definition 


Screen 
L) 
A.L 
LOG messages 10ATLOG 
$$LOG 
TLOGPFl 
TLOGCMDl 
CTMHLOG 


A.P 
Print Plan 
CTDTPMM 
CTDSPMM 
TPMMPFl 
TPMMCMDl CTDHPMM 
Screen 


A.? 
WHY Screen CTDTDWY 
CTDSDWY 
TDWYPFl 
TDWYCMDl CTDHDWY 


R 
Report 
CTDTREP 
CTDSREP 
TREPPFl 
TREPCMDl 
CTDHREP 
Decollating 
Mission 
Definition 
Entry Panel 


R 
Job List 
CTDTREP 
CTDSDIR 
TREPPF3 
TREPCMDl 
CTDHRE2 


R 
Categories of CTDTREP 
CTDSDIR 
TREPPF3 
TREPCMDl 
CTDHRE3 
Library 


R 
Report 
CTDTCAT 
CTDSCAT 
TCATPFl 
TCATCMDl 
CTDHCAT 


Decollation 
Mission 
Definition 


Screen 


R:O 
Order 
CTMTJOB 
CTDSCAM 
TCAMPFl 
TCAMCMDl CTDHCAM 


Decollation 
Mission 


Screen 


M 
Mission 
CTDTMIS 
CTDSMIS 
TMISPFl 
TMISCMDl 
CTDHMIS 


Definition 
Entry Panel 


M 
Mission List 
CTDTMIS 
CTDSMSD 
TMISPF3 
TMISCMDl 
CTDHMl2 
u 


M 
Category List CTDTMIS 
CTDSMSD' 
TMISPF3 
TMISCMDl 
CTDHMl3 


IOA Ret 5.0.0 Administrator Guide 
E-3 


Appendix E: IOA Online Options Cross-Reference 
u 


M 
Print Mission CTDTPRT 
CTDSPRT 
TPRTPFl 
TPRTCMDl 
CTDHPRT 
Definition 


Screen 


M 
Backup 
CTDTBKP 
CTDSBK.P· 
TBKPPFl 
TBKPCMDl 
CTDHBKP 
Mission 
Definition 


Screen 


M 
Restore 
CTDTRST 
CTDSRST 
TRSTPFl 
TRSTCMDl 
CTDHRST 
Mission 
Definition 


Screen 


M.O 
Mission 
CTMTJOB 
CTDSMIM 
TMIMPFl 
TMIMCMDl CTDHMIM 


Order 


F 
PC Packet 
CTDTATF 
CTDSATF 
TATFPFl 
TATFCMDl 
CTDHATF 


Status 


F.Z 
Packet Zoom CTDTZTF 
CTDSZTF 
TDECPFl 
TDECCMDl 
CTDHZTF 
Screen 


F.I 
Packet Index CTDTITF 
CTDSITF 
TITFPFl 
TITFCMDl 
CTDHITF 


Screen 


u 
User Reports CTDTUSR 
CTDSABK 
$$USR 
TUSRPFl 
TUSRCMDl 
CTDHUSR 


Entry Panel 


u 
User Report 
CTDTUSR 
$$FRM 
TUSRPF2 
TUSRCMD2 
CTDHUS2 


Lists 
u 
U.N 
General 
CTDTNTP 
CTDSNTP 


Notepad 


Screen 


U.P 
Print Report CTDTUSR 
$$FRM 
CTDHUSI 


u.v 
Report 
IOATOLV 
CTDSOLV 
TOLVPFl 
TOLVGMDl 
CTDHOLV 


Viewing 
u.v 
Tag Notepad CTDTNTP 
CTDSNTP 
Screen 


U.E 
Report 
CTDTEXT 
CTDSEXT 
TOLVPF2 
TOLVCMii>l 
CTDHEXT 
Editing 


Screen 


U.E.1 
Edit Report 
CTDTLNF 
CTDSLNF 
TOLVPF3 
TOLVCMDl 
CTDHLNF 
Lines and 
Columns 


U.E.1.C Edit Report 
CTDTCLF 
CTDSCLF 
TOLVPF5 
TOLVCMDl 
CTDHCLF 


Columns 


U.E.2 
Include Lines CTDTINC 
CTDSINC 
TOLVPF4 
TOLVCMDl 
CTDHINC 
Based on 


Strings 


U.E.3 
Exclude 
CTDTEXC 
CTDSEXC 
TOLVPF4 
TOLVCMDl 
CTDIUNC 


Lines Based 


on Strings 


U.E.4 
Color Lines 
CTDTCOL 
CTDSCLR 
TOLVPF4 
TOLVCMDl 
CTDHCLR 


Based on 


Strings 
u 
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u 


T 
Recipient 
CTDTUTR 
CTDSUTR 
TUTRPFl 
TUTRCMDl 
CTDHUTR 
Tree Entry 
Panel 


T 
CONTROL-D CTDTUTR 
CTDSUTR 
TUTRPF2 
TUTRCMDl 
CTDHUT2 
Recipient 
Tree 


T 
CONTROL-D CTMTJOB 
CTDSTRM 
TTRMPFl 
TTRMCMDl CTDHTRM 
CHECK TREE 
Messages 


T.S 
CONTROL-D CTDTRCP' 
CTDSRGP 
TRCPPFl 
TRGPCMDl 
CTDHRGP 


Recipient 
Definition 


CONTROL-V 


A 
Mission 
CTDTAMS 
CTDSAMS 
TAMS PF I 
TAMSCMDl 
CTVHAMS 
Status 


A.Z 
zoom 
CTDTDEC 
CTDSDEC 
TDECPFl 
TDECCMDl 
CTVHDEC 
u 


Decollating 
Mission 
Definition 


A.Z 
ZOom 
CTDTAPR 
CTDSAPR 
TAPRPFl 
TAPRCMDl 
CTVHAPR 
Printing 
Mission 
Definition 


A.Z 
ZOom ·Restore CTDTARS 
CTDSARS 
TARSPFl 
TARSCMDl 
CTVHARS 


Mission 
Definition 


A.Z 
ZOom Backup· CTDTABK 
CTDSABK 
TABKPFl 
TABKCMDl 
CTVHABK 


Mission 
Definition 


A.Z 
ZOom 
CTDTABK 
CTDSABK 
TABKPFl 
TABKCMDl 
CTVHAMG 


Migration 
Mission 
Definition 


A.L 
LOG 
IOATLOG 
$$LOG 
TLOGPFl 
TLOGCMDl 
CTMHLOG 
Messages 


A.P 
Print Plan 
CTDTPMM 
CTDSPMM 
TPMMPFl 
TPMMCMDl CTVHPMM 
Screen 


A.? 
WHY Screen CTDTDWY 
CTDSDWY 
TDWYPFl 
TDWYCMDl CTVHDWY 


R 
Report 
CTDTREP 
CTDSREP 
TREPPFl 
TREPCMDl 
CTVHREP 


Decollating 
Mission 
Definition 
Entry Panel 
u 


R 
Job List 
CTDTREP 
CTDSDIR 
TREPPF3 
TREPCMDl 
CTVHRE2 
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u 


R 
Categories of CTDTREP 
CTDSDIR 
TREPPF3 
TREPCMDl 
CTVHRE3. 
Library 


R 
Report 
CTDTCAT 
CTDSCAT 
TCATPFl 
TCATCMDl 
CTVHCAT 


Decollation 
Mission 
Definition 


Screen 


R:O 
Order 
CTMTJOS. 
CTDSCAM 
TCAMPFl 
TCAMCMDl CTVHCAM 
Decollation 
Mission 


M 
Mission 
CTDTMIS 
CTDSMIS 
TMISPFl 
TMISCMDl 
CTVHMIS 


Definition 
Entry Panel 


M 
Mission List 
CTDTMIS 
CTDSMSD 
TMISPF3 
TMISCMDl 
CTVHMI2 


M 
Category List CTDTMIS 
CTDSMSD 
TMISPF3 
TMISCMDl 
CTVHMl3 


M 
Print Mission CTDTPRT 
CTDSPRT 
TPRTPFl 
TPRTCMDl 
CTVHPRT 


Definition 


Screen 


M 
Backup. 
CTDTBKP 
CTDSBKP 
TBKPPFl 
TBKPCMDl 
CTVHBKP 


mission 
Definition 


Screen 


M 
Migration 
CTDTBKP 
CTDSBKP 
TBKPPFl 
TBKPCMDl 
CTVHMIG 
u 
mission 
Definition 


Screen 


M 
Restore 
CTDTRST 
CTDSRST 
TRSTPFl 
TRSTCMDl 
CTVHRST 


Mission 
Definition 


Screen 


M.O 
Mission 
CTMTJOB 
CTDSMIM 
TMIMPFl 
TMIMCMDl CTVHMIM 
Order 


F 
PC Packet 
CTDTATF 
CTDSATF 
TATFPFl 
TATFCMDl 
CTVHATF 


Status 


F.Z 
Packet Zoom CTDTZTF 
CTDSZTF 
TDECPFl 
TDECCMDl 
CTVHZTF 
Screen 


F.I 
Packet Index CTDTITF 
CTDSITF 
TITFPFl 
TITFCMDl 
CTVHITF 


Screen 


u 
User Reports CTDTUSR 
CTDSABK 
$$USR 
TUSRPFl 
TUSRCMDl 
CTVHUSR · 


Entry Panel 


u 
User Report 
CTDTUSR 
$$FRM 
TUSRPF2 
TUSRCMD2 
CTVHUS2 


Lists 


U.N 
General 
CTDTNTP 
CTDSNTP 


Notepad 


Screen 


U.P 
Print Report CTDTUSR 
$$FRM 
CTVHUSI 


u.v 
Report 
IOATOLV 
CTDSOLV 
TOLVPFl 
TOLVCMDl 
CTVHOLV 


Viewing 
u 
u.v 
Tag Notepad CTDTNTP 
CTDSNTP· 
Screen 
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\ 


CONTROL-0 
\_} 


OR 
Rule 
CTOTOMP 
CTOSOMP 
TOMPPFl 
TOMPCMDl CTOHOMP 
Definition 
Entry Panel 


OR 
Tables/Rules CTOTOMP 
CTOSDIR 
TOMPPFl 
TOMPCMDl CTOHOM2 


of Library 


OR 
Order/Force 
CTOTOMP 
CTOSOMM 
TOMPPFl 
TOMPCMDl CTOHOM3 


Messages 


OR 
Rule 
CTOTRUL 
CTOSRUL 
TRULPFl 
TRULCMDl 
CTOHRUL 


Definition 


Screen 


OM 
MSG 
CTOTMSC 
CTOSMSC 
TMSCPFl 
TMSCCMDl 
CTOHMSC 


Statistics 


OS 
Rule Status 
CTOTARF 
CTOSARF 
$$ARF 
TARFPFl 
TARFCMDl 
CCTOHAR 


OS 
Error 
CTOTARM 
CTOSARM 
TARMPFl 
TARMCMDl CTOHARM 
Messages 


OS 
Why(?) 
CTOTOWY 
CTOSOWY 
TOWYPFl 
TOWYCMDl CTOHOWY 


OL 
Automation 
CTOTALO 
$$ALO 
TALOPFl 
TALOCMDl 
IOAHALO 


Log 


OA 
Automation 
CTOTAOP 
$$AOP 
TAOPPFl 
TAOPCMDl 
CTOHAOP 
\_J 
Options 
##AOP* 


COM:MAND 
CTOTMCS 
$$AOPCMD TAOPPFl 
TAOPCMDl 
CTOHAOP 


CONSOLE 
CTOTCNS 
$$AOPCNS 
TAOPPFl 
TAOPCMDl 
CTOHAOP 


ENQINFO 
CTOTGES 
$$AOPGES 
TAOPPFl 
TAOPCMDl 
CTOHAOP· 


GLOBALS 
CTOTGLB 
$$AOPGLB 
TAOPPFl 
TAOPCMDl 
CTOHAOP 


SUBSYS 
CTOTSBS 
$$AOPSBS 
TAOPPFl 
TAOPCMDl 
CTOHAOP 


SERVERS 
CTOTSRV 
$$AOPSRV 
TAOPPFl 
TAOPCMDl 
CTOHAOP 


OA 
OPERATOR 
CTOTAMN 
$$AO PO PR TAOPPFl 
TAOPCMDl 
CTOHAOP 


Menu 
##OPER"' 


OA 
SAMPLE 
CTOTAMN 
$$AOP 
TAOPPFl 
TAOPCMDl 
CTOHAOP 


Menu 
##SAMPLE* 


OA 
SLIP Menu 
CTOTAMN 
$$AOPSLP 
TAOPPFl 
TAOPCMDl 
CTOHAOP· 
##SLIP* 


OA 
Operator 
CTOTMCS 
$$AOPCMD TAOPPFl 
TAOPCMDl 
CTOHAOP 
Command 


*Data for the Format member. 
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( 
·. 
\._) 
CONTROL-B 


BB 
Balancing 
CTBTABS 
CTBSABS 
$$ABS 
TABSPFl 
TABSCMDl 
CTBHABS 
Status 


BB.L 
LOG messages IOATLOG 
$$LOG 
TLOGPFl 
TLOGCMDl 
CTMHLOG 


BB,? 
WHY screen 
CTBTBWY 
CTBSBWY 
TBWYPFl 
TBWYCMDl CTBHBWY 
displayed for 
a rule. 


BM 
Mission 
CTBTBAL 
CTBSBAM 
TBALPFl 
TBALCMDl 
CTBHBAL 
Definition 


BM 
Mission List 
CTBTBAL 
CTBSBAD 
TBALPF3 
TBALCMDl 
CTBHBA2 


BM 
Category List CTBTBAL 
CTBSBAD 
TBALPF3 
TBALCMD3 
CTBHBA3 


BM.S 
Balancing 
CTBTBMD 
CTBSBMD 
TBMDPFl 
TBMDCMDl CTBHBMD 
Mission 
Definition 


Screen 


BV 
Database 
CTBTDAT 
CTBSSCH 
TDATPFl 
TDATCMDl 
CTBHDAT 
Variables 
Definition 
Facility 


BV 
Database 
CTBTDAT 
CTBSDAR 
TDATPF3 
TDATCMDl 
CTBHDA2 


I 
Facility- 
\_) 
Group List 


BV 
Database 
CTBTDAT 
CTBSDAR 
TDATPF3 
TDATCMDl 
CTBHDA3 
Facility- 
Variables List 


BV.G 
Display 
IOATGRU 
$$BVG 
TGRPPFl 
TGRPCMDl 
IOAHGRU 


Variable by 
Graph 


BV.V 
Display And 
CTBTDBV 
CTBSDBV 
$$DBV 
TDBVPFl 
TDBVCMDl 
CTBHDBV 
Update 


Variables In 
Active File 


BV.S 
CONTROL-B CTBTMOD 
CTBSMOD 
TMODPFl 
TMODCMDl CTBHMOD 
Variable 


Definition 


BR 
Rule 
CTBTRLB 
CTBSRLB· 
TRLBPFl 
TRLBCMDl 
CTBHRLB 
Definition - 
Entry Panel 


BR 
Rule List 
CTBTRLB 
CTBSDIR 
TRLBPF3 
TRLBCMDl 
CTBHRL2 


BR.S 
Rule 
CTBTRUM 
CTBSRUM 
TRUMPFl 
TRUMCMDl CTBHRUM 
Definition 


Screen 


BR.S 
Rule 
CTMTJOB 
CTBSJOB 
TJOBPFl 
TJOBCMDl 
CTBHJ0B 
Definition 
Compiler 
Messages 


; 
Screen 
u 
BA 
Rule Activity CTBTJBL 
CTBSJBL 
TJBLPFl 
TJBLCMDl 
CTBHJBL 
Entry Panel 
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BA 
Rule Activity CTBTJBL 
CTBSJAC 
$$JAF 
TJBLPF2 
TJBLCMDl 
CTBHJB2 


BA 
CONTROL-B• CTMTJOB 
CTBSJER 
TJERPFl 
TJERCMDl 
CTBHJER 
List-Editing- 
Format Error 
Messages 


BA 
CONTROL-B CTMTJOB 
CTBSJRP 
TJRPPFl 
TJRPCMDl 
CTBHJRP 
Report 


Viewing 


BA.G 
Display 
10ATGRU 
$$BJG 
TGRPPFl 
TGRPCMDl 
IOAHGRU 


Variable by 
Graph 


CONTROL-T 


TR 
Rule 
CTTTRLD 
CTTSRLD 
TRI:.DPFl 
TRLDCMDl .CTTHRLD 


Definition 
Entry Panel 


TR 
Rule 
CTTTRLD 
CTTSDIR 
TRLDPF3 
TRI:.DCMDl 
CTTHRL2 
Definition 
u 
List of Tables 


TR 
Rule 
CTTTRI:.D 
CTTSDIR 
TRI:.DPF3 
TRI:.DCMDl 
CTTHRL3 


Definition 
List of Rules 


TR 
Rule 
CTTTRLM 
CTTSRLM 
TRLMPFl 
TRLMCMDl CTTHRLM 


Definition 


Screen 


TP 
Pool 
CTTTPLD 
CTTSPLD 
TPLDPFl 
TPLDCMDl 
CTTHPLD 


Definition 
Entry Panel 


TP 
Pool 
CTTTPLD 
CTTSPDR 
TPLDPF3 
TPLDCMDl• 
CTTHPL2 


Definition 
List of Tables 


TP 
Pool 
CTTTPLD 
CTTSPDR 
TPLDPF3 
TPLDCMDl 
CTTHPL3 


Definition 
List of Pools 


TP 
Pool 
CTTTPLM 
CTTSPLM 
TPLMPFl 
TPLMCMDl CTTHPLM 


Definition 


Screen 


TV 
Vault 
CTTTVLD 
CTTSVLD 
TVLDPFl 
TVLDCMDl 
CTTHVLD 


Definition 
Entry Panel 


TV 
Vault 
CTTTVLD 
CTTSVDR 
TVLDPF3 
TVLDCMDl 
CTTHVL2 
Definition 
Table List 


TV 
Vault 
CTTTVLD• 
CTTSVDR 
TVLDPF3 
TVLDCMDl 
CTTHVL3 
u 
Definition 
Vaults List 
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u 


TV 
Vault 
CTTTVLM 
CTTSVLM 
TVLMPFl 
TVLMCMDl CTTHVLM 
Definition 
Screen 


TI 
Inquire/ 
CTTTINQ 
$$INQ 
TINQPFl 
TINQCMDl 
CTTHINQ 
UpdateMDB 
Entry Panel 


TI 
Inquire/ 
CTTTINQ 
$$INS 
TINQPF3 
TINQCMDl 
CTTHINS 
UpdateMDB 
Variables 
List 


TI 
Inquire/ 
CTTTUPR 
$$lJPV 
TUPRPFl 
TUPRCMDl 
CTTHUPR 
UpdateMDB· 
Volume 
Update 
Screen 


TI 
Inquire/ 
CTTTUPR 
$$UPD 
TUPRPFl 
TUPRGMDl 
CTTHUPR 
UpdateMDB 
Dataset 
Update 
Screen 


TC 
Check In 
CTTTKIN 
$$KIN 
TKINPFl 
TKINCMDl 
CTTHKIN 
External 
Volume 
v 


v 
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ISPF· 


6 
ISPF - UTILITIES 
IOAIUTI 


M 
CTMPUTI 
CTMPUTIJ 


D 
CTDPUTI 


T 
CTTPUTI 
CTTPUTH 


M+D 
CTMPUTID 
CTMPUTIX 


D+T 
CTTPUTID· 
CTTPUTH 


M+T 
CTTPUTIM 
CTTPUTIN 
CTTPUTH 


M+D+T 
CTTPUTIS 
CTTPUTIX 
CTTPUTH 


M+B 
CTMPUTI 
CTMPUTIJ 


D+B 
CTDPUTI 


B+T 
CTTPUTI 
CTTPUTH 


M+D+B 
CTMPUTID 
CTMPUTIX 


D+B+T 
CTTPUTID 
CTTPUTH 


M+B+T 
CTTPUTIM 
CTTPUTIN 
CTTPUTH 


M+D+B+T 
CTTPUTIS 
CTTPUTIX 
CTTPUTH 


Dl 
Decola ting 
CTDMISRQ 


D2 
Printing 
CTDMISRQ 
u 


D3 
Backup/Migration 
CTDMISRQ 


D4 
Restore 
CTDMISRQ 


11 
Prerequisite 
IOACCND 


Conditions 


Ml 
Condition Job 
CTMJOBRQ 


Order Issue 


M2 
AutoEdit 
CTMCAES 
CTMPROMP 


M3 
Simulation 
CTMCSIM 


M4 
Simulation/l'ape pull 


Parameter 
Prompting 


M5 
Quick Schedule 
CTMQUICK 


M6 
User Interface 
CTMJBINT 


Tl 
CONTROL-T 
CTTCRSS 
Simulation 


u 
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Index 


-#- 


# OF DAYS TO KEEP 
Parameter 
Backup Missions, 4-56, 


# OF GENERATIONS TO 
KEEP Parameter 
Backup.Missions, 4-56 


..., Operator 


INCLUDE/EXC:tUDE 


Statements, 9-102 


-$- 


$$BA.NCHR Member 
Banner Printing,.4-48 


$$COMPST Member 
Global Library 


Compression, 5.14 


$$FRM Member 
Display Format Member 


(CTD), 2•20 
$$POOh Member 
PARM Library (CTT), 7-5 


$$USR Member 
Display Format Member 


(CTD), 2-20 
$$VAULT Member 


PARM Library (CTT),.7-5 


$FTEXIT Exit 


CA-ASM2Support, 7-36 
$GLOBAL 
Global Variable Member, 


5·12 


$INDEX Records 


CTVDELl Utility, 9•94 


$NTEXIT CA-ASM2 Exit, 
7-36 


$PROFFLD Member 
Global Profile, 2-32 


$PROFMOD Member 
Global Profile, 2-32' 
$PROFVAR Member 
Global Profile, 2~32 
$TAPPOOL CA-ASM2 


Parameter, 7-36 


-o/o- 


%%$AUTOLOG System 


Variable, 5·11 


%%$STATID Reserved 
Variable 
Message ID (CTO), 5,10 
%%STATUS Variable 
Global Library 


Compression,. 5-14 


%BKPUTIL% Parameter 
Restore Skeleton; 4-65 


%CATEGORY Parameter 
Printing Mission, 4-33 


%COM#% Parameter 
Printing Mission, 4-33 


%COND% Parameter 
Backup Missions, 4-55 
Migration Skeleton, 4-58 


%COUNTP Parameter 


CTTRPT Utility, 9-151 


%DEST% Parameter 
Printing Mission, 4-33 


%DSNS% Parameter 
Backup Mission, 4-55 · 


Migration Skeleton, 4-58 
Restore Skeleton, 4-64 
%ENDREPEAT% 
Parameter 
Restore Skeleton, 4-64 
%FIELD Parameter 


CTTRPT Utility, 9-151 


%GROUP% Parameter 
Printing Mission, 4-33 
%LEVEL% Parameter 
Migration Missions, 4-59 


%MISSION% Parameter 
Printing Mission, 4-33. 


%MISSNAME% Parameter 
Backup Mission, 4-55, 


Migration Skeleton, 4-58 
Restore Skeleton, 4-64 
%OWNER% Parameter 
Printing Mission, 4-33 
%PRTY% Parameter 
Printing Mission, 4-33 
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%REPEAT% Parameter 
Restore Skeleton, 4-64 


%TIMESTMP% Parameter 
Backup Mission, 4-55 
Migration Skeleton, 4-58 
Restore Skeleton, 4-64 


%VOLUMES% Parameter 
Restore Skeleton, 4-64 


-&- 


&A CSENVIR Parameter 


ACS Routines, 7-38 


DF/SMS Interface, 7-37 
&TAPEMGT Parameter 


CA-ASM2 Support, 7-36 


-=- 


=Operator 


INCLUDE/EXCLUDE 


Statements, 9-102 


-@- 


@Dli.M Line Type 
Display FoI"mat Member, 


2~24 


@END Line Type 
Display Format Member, 


2•24 


@FIELD Line Type 


Color Parameters, 2-24 
Display Format Member, 
2-22 
@HEADER Line Type 


Color Parameters, 2-24 
Display Format Member, 
2-21 
@LINE Line Type 


Color Parameters, 2-24 
Display Format Member, 
2-22 


@STYLE Line Type 


Color Parameters, 2-24 
Display Format Member, 


2-20 


@VAL Line Type 
Display Format Member, 


2"23 
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-3- 
Formatting,. 9-24 
ACTIVEDS Keyword 
(~ 


3480/90/90E Tape 
Initialization, 9"50 · 
Volume Record, D-6 
Cartridge 
Reformatting, 6-2 
ACTIVEDS Parameter 
Stopping/Starting a 
Searching, 6-9 
CTTMUP Utility, 9-137 
Device, 4-70 
Utilities, 9•4 
ADBPFUNC Variable 
3490 Tape Cartridge 
Active Jobs File 
API Error Handling, 7-71 
Utility CTTTPI', 9-182 
Changing Size, 9-47 
ADBPIOPR Variable 
Cleaning, 9"4 7 
CTTIOS Function, 7-71 
-A- 
Compressing, 9-47 
ADBPIRC Variable 


CONTROI;.-M, 3~4 
API Error Handling, 7 -71 
Abend. See also Error 
Dual Checkpoint Mode, 
ADBPIRSN Variable 
Backup·Missions, 4-56 
3~26 
API Reason Code, 7-71 
Migration MiSsions, 4-62 
Expanding (CTM), 3-35 
ADBPRC Variable 
ABENDACT Parameter 
Restoration, 3~26 
API Return Code, 7-70 
Modification (CTT), 7-4 
Active Library (CTT) 
AD11> Parameter 
ABFBKP File 
Adding Volumes,.9-122 
CTTTPI Utility, 9-186 
CTBABI Utility, 9-50 
Active Mission Screen 
Adding 
CTBFRM, 9-62 
Profile Variables, 2"36 
MDB Volume, 9-132 
Access Method. See IOA 
Active Missions File 
Volumes to MDB, 9-122 
Access Method 
Changing Size, 9-68 
ADDMODE Statement 
ACCESS Parameter 
Cleaning, 4-7 
IOALDNRS Utility, 9-36 
CTTTPl Utility, 9•187 
Compressing,. 9-68 
Addvess Space Vector 
ACCOUNT Keyword 
Expanding, 4-81 
Table. See ASVT 
Dataset Record, D-2 
New Day Procedure 
AD11>VOI;, Function 
u 
ACCONNT Parameter 
(CTD), 4-17 
High Level APl, 7-68, 
FileTek Media, 4-68 
Active Report List 
7-69 


ACIF Interface, 4-43 
Backup·Mission, 4-54 
Ad-hoc Maintenance 
Parameter Member 
Copy from Permanent, 
IOA Products, 8-4 
Format, 4-45 
9-77 
Advanced Function 
ACIFPARM Library 
Copying, 9-72' 
Printing.See AFP 
ACIF Interface, 4-45 
CTDIDELRP Utility, 4-78 
AFP Printing 


ACS Routines 
Deleting Reports,. 9-79 
Commands, 4-41 
Adjusting, 7-38 
Description, 4-76 
Page Markers, 4-40 
DF/SMS Interface,. 7-37 
Dynamic Sorting, 4-83 
Page Mode Output,.4-39 
ACT Parameter 
Migration Mission, 4-57 
Printing Missions, 4-38 


CTTDBID Utility, 9•119 
Active Transfer File 
AFPDS 


Utility CTBDBVIG, 9-61 
Changing Size, 9•70 
Description, 4-43 
Activating 
Compressing, 9-70 
Allocating. See also 


CDAM, 4-2 
Expanding, 4-81 
Creating, and Formatting 


CMEM Facility, 3~2 
Active User File 
CTT Files, 9-111 


CONTROL-D Monitor, 
Backup Utility, 9-87 
Trace Files (CTT), 9-114 
4-1 
Active User Report List 
Allocation Members 


CTB Missions, 6-5 · 
Copy to Permanent, 4-76 
Customization, 2•11 


Dynamic Dataset 
Copy to/from History, 
ALREC# Parameter 
Stacking, 7-41 
4-78 
Automation Log Size, 
Generic Processing CTD, 
Copy Utility, 4-78 
5-11 
4-1 
Permanent User Report 
Alternate Allocation, 2-12· 
I0A Online Monitor, 2"5 
\ 
List, 4-75 
AMFSIZE Parameter 
u 
VTAM Monitor, 2• 7 
Sorting, 4-82 
Active Missions File, 
Active Balancing File, 6-5 
4-81, 9-68 
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ANALYZE Step 
ARCJ©BID Keyword 
AutoEdit Facility 
Migration Mission, 4-58 
Trace Record, D-11 
Description, 1-12 
Migration Skeletons, 4-60 
ARCS 
Global Variables (CTO), 


Restore Missions,.4-65 
Backup Utility, 4-55 
5·12 
AOP. See Automation 
ARCTIME Keyword 
AUTOLOG Command 


Options 
Trace Record, D-11 
(CTO), 5-11 
APA Printing. See also AFP 
ARCTVEXT Exit 
Automatic Class Selection 
Printing 
HSM Tape Volume Exit, 
DF/SMS Interface, 7-37 
APA Technology 
7-35 
Automation Log 
Laser Printing, 4-38 
ARCTYPE Keyword 
Backup Utility, 9-100 
APAPARM Library 
Trace Record, D-11 
Changing Size, 9-100 
AFP Parameters, 4-40 
ARCUSRID Keyword 
Description, 5-10 


Format, 4-41 
Trace Record, D-11 
Search Limit, 2-42 


Sample Member, 4-41 
AS2FTEXT Member 
Size, 5-11 


APF Authorization 
CA-ASM2Support, 7-36 
Unecessary Messages, 


CTTGVL Utility, 9-125 
ASM2 
5-11 


High Level API, 7-68 
Backup Utility, 4-55 
Automation Options 


API'. See also High Level 
ASM3495 Member 
Client Programs, 5-24 


APL See also Base Level 
Interface to· IBM Robot, 
Format Members, 5-23 


API' 
7-26 
Menus, 5-19 
Base Level/High Level, 
ASMCTLEX Member 
Overview, 5-18 
7-46 
DMS/0S Support, 7-35 
AUTOMLOG Parameter 
CONTROl!i-T Interface, 
ASMMMRX Member 
(CTO), 5-10 


7-44 
u 


API(CTT) 
MEMOREX TELEX 
-B- 
Support, 7-32 
High Level, 7-68 
ASMRSTK Member 
Backup 
Application Program 
StorageTek Robot 
Automation Log, 5-11, 
Invoking CONTROL-B, 
Support, 7-29 
9-100 
6-7 
ASMTVEXT Member 
MDB and Trace File, 
Application Programming 
HSM Support (CTT), 7-35 
9-192 
Interface. See API 
ASMUXCUA Member 
Medfa Database, 7-9 
APPLTYPE Parameter 
IBM Robot Support, 7-26 
Retention and Volser 
IOAONL CLIST, 2•2 
ASMUXEJ8 Member 
(CTD),.9-87 
APPLY Parameter 
IBM Robot Support, 7-27 
Backup.and Recovery 


CTTMUP Utility, 9-132 
ASMUXVNL Member 
Repository (CTT), 7-23 


ARCCPUID Keyword 
IBM Robot Support, 7-27 
Backup File (CTB) 


Trace Record, D-11 
ASVT 
Formatting, 9-24 


ARCDATE Keyword 
MVS Table, 2•6, 4-4 
BACKUP IN PROCESS 


Trace Record, D-11 
ATFSIZE Parameter 
Status 
Archive Server, 4-66; 
Active Missions File, 4-81 
Backup Mission, 4-56 


DIJ> Statements,4-73 
CTDFRATF Procedure, 
Backup· Mission 
Deactivating, 4-5 
9•70 
Abend, 4-56 
Problem Determination, 
CTDPARM Member, 9-70 
Advanced Scheduling, 
4-73 
ATTRStatement 
4-52 
Archiving 
CTTRPT Utility, 9•148 
Decollation Missions, 
External Resources 
4-52 


(ACIF), 4-44 
CTTRTM Utility, 9-170 
Default Missions, 4-15 


ARCIDENT Keyword 
CTTVTM Utility, 9-198 
Exception Handling, 4-56 
u 
Trace Record, D-11 
Authorization. See Security 
Overview, 4-51 
Profile Variable, 2-36 
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Retention Period, 4-56 
BLOCKCT Keyw.ord 
Pool Definition,. 7-36 
u 


Scheduling, 4-13 
Dataset Record, D-2 
Calendar. See also 
Workflow, 4-54 
BLPDEF Parameter 
Scheduling Facility 
Balance Workload 
Modification (CTT), 7-4 
Building, 9-1 
I0A Online Monitovs, 2~5 
Bosch 
Tables, 1-9 
Balancing Activities 
Tape Library Support, 
CALL Command 


Invoking, 6-7 
7-32 
CTTGVL Utility, 9•125 


Balancing Mission (CTB) 
BOXID Keyword 
CA-ROSCOE. See ROSCOE 


Invoking, 6-9 
Volume Recovd, D-6 
CART Media 
Scheduling, 6~2' 
BOXLIM Parameter 
Media Definition, 4-67 
Banner 
CTTVTM Utility, 9-195 
Migration Target, 4-60' 
Printing Characteristics, 
BREAK Statement 
Stopping/Starting a 
4-48 
CTTRPT Utility, 9-150 
Device, 4-70 


Bar-code 
CTTRTM Utility, 9•170 
Cartridge Message Display 


AFPDS Printing, 4-43 
CTTVTM Utility, 9-198 
Customization, 7-33 · 
Base Level AP! (CTT) 
Browse·Mode 
Cartridge to Disk 
Examples, 7-53 
Profile Variable, 2•40 
Migration Skeleton, 4-60 


Functions, 7-4 7 
BTLS Support, 7-27 
Cataloging 
High Level AP!, 7-46 
BTLSDIGS Parameter 
Datasets (Utility 


Macro CTTI0S, 7-4 7 
IBM BTLS Support, 7-27 
CTTRCV), 9-141 


Medfa Database Access, 
BTLSIN DD Statement 
CATEGORY5 


7-51 
BTLS Support, 7-28 
AFP Printing, 4-39 
Read Entive MDB, 7-53 
BTLSOUT DD Statement 
Category Field 
Record Access, 7-4 7 
BTLS Support, 7-28 
Job Scheduling, 4-26 
u 
Basic Tape Library 
BTLSUNIT Parameter 
CA-TLMS 
Support. See BTLS 
BTLS Library Unit, 7-27 
Compatibility, 9-164 


BATCH Parameter 
Buffer Address 
Conversion, of Retention 
Printing Mission, 4-32 
High Level API, 7-69 
Information, 9-168 


BKP'Pavameter 
BUFL Parameter 
Conversion Utility, 9-123 


CTTTRB Utility, 9-192 
IOADBF Utility, 9-22 
CBRUXCUA User Exit 


BKPLIST Member 
Building 
IBM Robot, 7-26 
Backup· Missions, 4-14 
Manual Conditions File, 
CBRUXEJe User Exit 
Migration Missions, 4-14 
9-35 
IBM Robot, 7-26, 


BKPMIS Parameter 
Stacking Statistics File, 
CBRUXENT User Exit 


Utility CTDUPBKP, 9•88 
9-177 
IBM Robot, 7-27 


BKPORDER KSL Utility 
Bundle Printing (CTD), 
CBRUXVNL User Exit 
Backup Missions, 4-16 
4-34 
IBM Robot, 7-27 


BKPRESET Job 
CDAM 


Backup Mission Rerun, 
-C- 
Activating, 4-2 
4-56 
C Parameter 
AFP Printing, 4-39 


BKPTO Parameter 
Utility CTBJAFIG, 9-67 
Deactivating, 4-5 


Utility CTDUPBKP; 9-88 
CA-1 
Deleting Files, 9• 7 4 
BLK Parameter 
Compatibility, 9-164 
Parameters, 4-39 


CTTCRDF Utility, 9-112 
Conversion of Retention 
CDS Backups 


BLKSIZE Keyword 
Information, 9-168 
HSM Control, 7-35 
Dataset Record, D-2 
Conversion Utility, 9-123 
CHANGETO Parameters 


BLKSIZE Parameter 
CA-7 (UeC7) Interface, 
CTD'C!JPBKP Utility, 9-89 
Exit CTDX005, 4-51 
4-28 
CHECK Mode 
u 
I<~ADBF Utility, 9•21 
CA-ASM2·Support, 7-36 
CTTINIT Proceduve,. 7-4 


Index-4 
IOA Rel• 5.0.0 Administrator Guide 


Index 


\_;1 
CHECK Parameter 
CMD Pavameter 
COL.ORA Parameter 
CTTMUP Utility, 9-132 
IOATEST Utility, 9•39 
Display Format Member, 


CHECKACT Parameter 
CMEM Facility 
2-25 


CTTRCV Utility, 9-141 
Activation, 3~2 
COLUMN Parameter 
Checking. See Verification 
CONTROL-0 Installed, 
CTTRPT Utility, 9-151 
CHKINDT Keyword 
5-1 
Command Members 


Volume Record, D-6 
CTO Installed, 5-25 
Format, 2'-13 
Chunk Printing. See 
Deactivating a Rule 
Modification, 2-13 


One-Chunk Method or 
Table, 3~28 
Online Facility, E-1 
Multi-Chunk Method 
Debugging, 3"30 · 
Commands 


CHUNKSIZE Parameter 
Description, 3-26 
Customization, C-1 


Bundle Printing,.4-35 
Display Active Rules, 
Online Facility, 2 .. 13 
Bundle Printing (CTD), 
3;.29 
COMMNDnn Member, 5-6 
4-35 
Multiple Rule Tables, 5-7 
Communication Monitors 


CICS 
Profile Variable, 2-43 
(CTM), 3 .. 35 
I0A Online Support, 2'-1 
Replacing a Monitor, 3-3 
Communications File 
Memory Requirement, 2-4 
Replacing Rule Tables, 
Inter-System 


CKPSIZE Pat1ameter 
3~28 
Communications (CTM), 


Active Jobs File Size, 9-47 
Resource Utilization, 3~32 
3-32 


CLASS JES Parameter 
Rule Loading, 3-27, 5-3 
COMPAREX Robots 
Multi-Chunk Printing, 
Rule Operation Mode, 
CONTROL-T Support, 


4-35 
3 .. 29 
7-25 


CLASS Parameter 
Security Cache, 3-30 · 
Compiling 


' 
@STYLE Display Format 
Shutting Down, 3-3. 
Rule Definitions (CTB), 
\_) 
Line, 2 .. 21 
Sleeping Interval, 3~30 · 
9-51 


CLASSLIKE Parameter 
CMORDER Parameter 
COM-Pl!.ETE 
@STYLE Display Fovmat 
CONTR0I1-0 Procedure, 
Color Support, 2-26 
Line, 2-21 
5-3 
I0A Online Support, 2-1 


Cleaning 
Rule Lists (CMEM), 5-7 
COMPRESS Function 
Active Jobs File, 9-47 
CNGMSGID Parameter 
CTMCAJF Utility, 9-45 
Conditions/Resouvces 
Modification (CTT), 7-4 
Compressed Dataset Access 
File, 9-7 
CODE Parameter 
Method. See CDAM 


History User Report List, 
CTMMMSG Macro, 2~4 7 
Compressing 
9-76 
COLOR· Parameter 
Active Jobs File, 9-47 
Migrated Report List, 9•93 · 
Display Format Member, 
Active Missions File,. 9-68 


CLEANUP Function 
2'-25 
Active Transfer File, 9•70 
CTMCAJF Utility, 9•45 
Color Support 
Global AutoEdit Library, 
Client Programs 
COM-PLETE, 2"26 
5-14 
Automation Options, 5-24 
Customization, 2-26 
COMPRS Parameter 


CLIST 
Display Format Member, 
IOADBF Utility, 9-22 
Entry to Online Facility, 
2'-24 
COMPTB· Parameter 


2-2 
Extended, 2 .. 25 
IOADBF Utility, 9-22 
Mission Scheduling 
IDMS/DC,2-25 
Condition, See Prerequisite 


(CTDN), 4-16 
IMS/DC, 2-25 
Condition 


CLNCOtJNT Keyword 
IRMA, 2-26 
Conditions Selection List 


Volume Record, D-6 
!SPF, 2-25 
(CTM), 3 .. 33 


Clock 
Profile Variables, 2-39 
Conditions/Resources File 


Changing Time, 3-23 
Backup Missions, 4-55 


u 
CLOSE Function 
Cleaning Utility, 9-7 


Base Level API (CTT), 7-4 7 
Copying,. 9-14 
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Description, 1-8 
Expanding, 2.:.49 


IOACND Utility, 9•10 


Conditions/Resources 
Screen 
Profile Variable, 2•38 
CONID Parameter 
IOATEST Utility, 9-39 
Constant Blocks 
I0A Screen Definition, 
2-18 
Constants 


IOA Screens, 2-17 


CONTDAY Procedure 
Customization (CTM), 
3-10 


DAREPMISDD 
Statement, 4-24 
New Day Processing 


(CTM), 3:.6 
CONTROL D/PC 
AFP Viewing Component, 
4-44 


CONTROL Products.See 
IOA or specific product 


Control Resources 
Adding/Deleting, 9•10· 


Description, 1-8 
Control' Statements 
AFP, 4-40 
CTTMUP Utility, 9-132 
Control Table (CTT), 7-45 
Loading, 7-47, 7-54 


Control Table (TCT) 
CONTROL-T 


Initialization, 7-2 


CONTROL-B 


Activating Missions, 6-5 


Compile Rule Definitions, 
9-51 
Database Integrity, 9-61 
Deleting Variables,. 9•59 


Initialize Active 
Balancing File, 9•50 


Invocation Utilities, 9-4 
Invoking via 


CONTROL-D, 6-8 
Invoking via 


CONTROL-M, 6-8 
IOA Access Method, 2'-29 


Job Step Invocation, 6-8 
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Online Facility Members, 
E-9 
Rebuild Index, 9-52 
Report Utilities, 9-4 
Repository, 1-11 


Rule Activity File 
Integrity, 9•67 


Runtime Environment, 


6'-6 
Utility Summary, 9-4 
Variable Generations, 
9-54 
Variable Group Utilities, 


9-4 


CONTROL-D 


Bundle Printing, 4-34 
Chunks on the Spool~ 


4-38 


CONTROL-M, 4-23 
Daily Maintenance, 4-7 
Date Control Record, 4-7 
Generic Processing, 4-1 
Initialization, 4-1 
Invoking CONTROL-B; 


6-8 


IOA Access Method, 2-29 
Monitor Activation, 4-1 
New Day Processing, 4-10 


Number of Users, 2.:.5 
Online Facility Members, 
E-3 


Online Viewing,. 2:.5 


Repository, 1-10 


Sleeping Interval, 4-2 


SMF Accounting,. 4-84 


User Daily, 4-7 


User Groups, 4-22 


Utilities, 9-68 


Utility Summary, 9-2 


CONTROLD ONTPUT 


Statement 


AFP Printing, 4-39 


CONTROIJ.D Statement 


IOACLRES Utility, 9-8 
IOALDNRS Utility, 9-36 


CONTROI:.F OUTPlJT 


Statement 


AFP Printing (CTD), 4-39 


CONTROl!.-M 


Active Jobs File, 3:.4, 9.:.45 


Administration, 3-1 


CONTROIJ.-D, 4-23 


CONTROL-0, 5-25 
Dual Checkpoint Mode, 


3'-26 


File Expansion, 3.:.35 


Initialization,. 3-1 
Inter System 
Communications, 3.:.32 


Invoking CONTROb-B, 


6-8 
Job Ordering, 3-4 
Maintenance Jobs, 3-6 
Monitor, 3-1 
Monitor Shutdown, 3:.1 


New Day 
Implementation, 3'-10 


New Day Processing, 3-4 


Online Facility Members, 
E-2 
Repository, 1-9 
Rerun Backup Mission 
(CTD), 4-56 


Rerun Migration, Mission 


(CTV), 4-62 
Rerun Restore Mission 
(CTD), 4-65 
Scheduling Library, 4-24 
Sleeping Interval,. 3.:.2 
User Daily Job, 3~4 
Utility Summary, 9-2 


CONTROL-M Event 
Manager. See CMEM 


Facility 


CONTROLM Statement 
IOALDNRS Utility, 9-36 


CONTROL-0 


Administration, 5-2 
Automation Log, 5-10 


CMEM, 5-25 


CMEM Control, 5-1 


CONTROL-M, 5-25 
Deactivating a Rule 
Table, 5-5 
Debugging, 5-16 
Internal Data Areas, 5-17 


IPL Automation, 5·5 
IPL Process, 5-8 
Message Statistics, 5-9 
Multiple Rule Tables, 5-7 
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~ 
Online Facility Members, 
Migration Mission, 4-56 
Variable Files (CTB), 
E-8 
Online Facility Members, 
9-56 
Replacing a Monitor, 5-2 
E-5 
COPYTOLOG Pavameter 


Repository, 1-10 
Reports, 4-77 
Utility IOACPLOG, 9•17 


Resource Utilization, 5-18 
CONVABF Job 
COPYTOSEQ Parameter 
Security Cache, 5-16 
IOADBF Utility, 9-23 
Utility IOACPI:.OG, 9-16 


Shutting Down, 5-1 
CONVC4MD Job 
COUNT Parameter 


Sleeping Interval, 5-15 
CTTDLD Utility, 9-123 
CTTRPT Utility, 9-151 
Starting, 5-1 
CONVC5MD Job 
CPUID Keyword 
Utilities, 9-98 
CTTDLD Utility, 9•123 
Trace Record, D-11 
Utility Summary, 9-3 
Converting 
Creating 


CONTROL-R 
Volume Records, 9•122 
Trace Files, 9-114 


CTT Interface, 7-43 
CONVGRPJob 
CRECC Keyword 


CONTROL-T 
IOADBF Utility, 9-23 
Dataset Record, D-2 
API Interface, 7-44 
CONVJAFJob 
CRECPU Keyword 
Backup and, Recovery, 
IOADBF Utility, 9"23 
Dataset Record, D-2 
7-23 
CONVLCTL Job 
CREDDN Keyword 


Control Table, 7-2; 7-45 
CTTDLD Utility, 9-123 
Dataset Record, D-2 


CTR Interface, 7-43 
CONVMODJob 
CREDT Keyword 
Database Printing, 9'-121 
IOADBF Utility, 9-23 
Dataset Record, D-2 
Dormant Mode, 7-4 
CONVREPJob 
CREFABFJob 
EDM Support, 7_35, 
HDADBF Utility, 9-24 
IOADBF Utility, 9•23 


Initialization, 7-2; 7-3 
CONVRMDB Job 
Utility CTBABI, 9-50 


( 
Media Database 
CTTDLD Utility, 9-123 
CREFBKPJob 
\ 
! 
~ 
Integrity, 7-19 
CONVTMDB Job 
IOADBF Utility, 9-23 


MVS Interface 
CTTDLD Utility, 9•122 
Utility CTBABI, 9-50 
Parameters (CTT), 7-4 
Copy Count 
CREFDBM Job· 
M:VS Interfaces, 7-2 
Active User Report List, 
IOADBF Utility, 9-23 
New Day Procedure, 7-7 
4-76 
CREFDBV Job 
Normal Mode, 7-5 
Report List Files, 4-75 
IOADBF Utility, 9-23 
Online Facility Members, 
COPY Function 
CREFGRPJob 
E-10 
CTMCAJF Utility, 9-45 
IOADBF Utility, 9'-23 
Operating Status, 7-4 
COPY Parameter 
CREFJAFJob 
Operation Mode, 7-8 
CTBDBVCG Utility, 9•54 
IOADBF Utility, 9-23 
Overview, 7-1 
CTBDBVCP Utility, 9-56 
CREFREPJob 
Real-time Environment, 
COPY Statement 
IOADBF Utility, 9"23 
7-1 
Repository, 1-11 
CTTACP Utility, 9-106 
CREJBN Keyword 


Repository Field Names, 
Copying 
Dataset Record, D-2 


D-1 
Active Repovt List, 9-72 
CREJOBID Keyword 


Stacking Facility, 7-39 
Conditions/Resources 
Dataset Record, D-2 
Suspended Mode, 7-5 
File, 9-14 
CRESTEP Keyword 


SVC Number, 7-2 
Database Records, 9-172 
Dataset Record, D-2 


Termination, 7-3, 7-6 
IOA Log File, 9-16 
CRETM Keyword 


Utilities, 9-102 
Message Statistics File, 
Dataset Record, D-2 
9-98 
Utility Summary, 9-5 
Permanent User Report 
CREUAD Keyword 


CONTROh-V. See also 
List (CTD), 4-76 
Dataset Record, D-2 


.. 
CONTROL-D 
Rule Activity File, 9-63 
CREUSER Keyword 
/ 
. 
Dataset Record, D-2 
\._) 
Customization, 4-1 
Trace File (CTT), 9-106 
Initialization, 4-1 
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Cross Memory Interfaces 
CTD34F Program 
New Day Processing, 4-6 


. 
) 
\._, 


Online Facility, 2"1 
CTD Daily, 4-12' 
CTDNDAY Started Task 
Cross-Product Interfaces 
CTDAMUTI Utility, 9-2 
Abend, 4-5 


CTM and CTD, 4-27 
CTDBRQ Program 
CTDPDA Program, 4-9 
CTT and CTR, 7-43 
CTD Daily, 4-11 
CTD Daily, 4-12' 


CRPEGM Keyword 
CTDCA2P Utility 
CTDPRINT Procedu11e 


Dataset Reco11d; D-2 
Copy User Report List, 
Printers Control1 Monitor, 


CSC Support 
9•72 
4-38 
StorageTek Robot, 7-29 
Description, 4-76 
CTDPRQ Program 
CSECT List 
CTDCAMF Utility 
CTD Daily, 4-11 
Online Facility, E-1 
Compress Active Missions 
CTDRRQ Program 


CTBABI Utility 
File, 9-68 
CTD Daily, 4-12 
Active Balancing File, 
CTDCATF Utility 
DD Statements, 4-28 


9-50 
Compress Active Transfer 
Production Control 


CTBBAO Program 
File, 9-70 
System, 4-28 
New Day Procedure 
CTD Daily, 4-11 
CTDSMFRP Utility, 9-3 
(CTB), 6·1 
CTDCCU Utility 
CTDSRQ Program 
CTB<CHK Program 
Deleting CDAM Files, 
CTD Daily, 4-11 
New Day Procedure 
9-74 
CTDUDJP Macro 
(CTB), 6·1 
CTDCHK Program, 4-8 
DJDE Printing, 4-43 


CTBCMP Utility 
CTD Daily, 4-11 
CTDUPBKP Utility 


Compile Rules, 9-51 
CTDCLHIS Utility 
Backup Retention and 


CTBDBIB Utility 
Clean History Report 
Volser Info; 9"87 


Rebuild, CTB Index, 9•52 
List, 9-76 
Dual Migration,. 4-59 
., 
CTBDBVCG Utility 
Description, 4-79 
CTDX001 Exit 
(_,/ 


Variable Generations, 
CTDCP2A Utility 
Mission Scheduling, 4-17 
9-54 
Copy User Report List, 
Production Control 
CTBDBVCP Utility 
9-77 
Systems, 4-28 
Copy CTB Variables, 9-56 
Description, 4-76 
Scheduling with CTM, 
CTBDBVDI:, Utility 
CTDDELRP Utility 
4-23 
Deleting Variables, 9-59 
Deleting Reports, 9-79 
CTDX005. Exit 


CTBDBVIG Utility 
Description, 4-78 
Customization, 4-49 
Variable File Integrity, 
CTDDIB Utility 
Printing to a File, 4-49 


9•61 
Access Method Index, 
CTDX009 Exit 
CTBFRM Utility 
9-86 
Printing Missions, 4-33. 
Active Balancing File, 6·2 
CTDFRAMF Procedure 
CTDXOlO Exit 
New Day Procedure 
Active Missions File, 9-68 
Backup.Missions, 4-55 
(CTB), 6·1 
CTDFRATF Procedure 
Migration Missions, 4-58 


CTBJAFCP Utility 
ATFSIZE Parameter, 
CTDXOll Exit 
Rule Activity File, 9-63 
9•70 
Restore Missions, 4-65 
CTBJAFDL Utility 
CTDFRM Program 
CTMAESIM Procedure, 
Rule Activity File, 9-65 
CTD Daily, 4-11 
3-25 


CTBJAFIG Utility 
CTDGRQ Program 
CTMAJO Routine 
Rule Activity File 
CTD Daily, 4-11 
Printing Missions (CTD), 


Integrity, 9-67 
CTDILY Program 
4-33 
CTBNDAY 
DID Statements, 4-15 
CTMBGRP Utility 


New Day Procedure, 6·1 
CTDMISRQ CLIST 
G11oup Scheduling Tables, 


CTBPDA Program 
Mission Scheduling, 4-16 
9-43 
u 
New Day Procedure 
CTDNDAY Procedure 
CTMCAJF Utility 
(CTB), 6·1 
Mission Scheduling, 4-13 
Active Jobs File, 9-45 
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Restoring the Active Jobs 
CTMSEND Macro 
CTTCHKDB Macro 
File, 3~26 
IOA Screen Definition, 
High Level API, 7-70 
CTMCH:K Program, 3"17 
2-17 
CTTCMDB Job 
New Day Processing, 3-16 
CTMSFLD Macro 
Utility CTTCRDF, 9-113 


CTMC:JOBS CLIST, 4-24 
Format, 2-18 
CTTCRDF Utility 
CTMCLRES Utility, 3-6, 
IOA Screen Definition, 
Allocate/Format CTT 


3~11 
2-17 
Files, 9-111 


CTM8MEM Operator 
CTMSSTA Macro 
CTTCSTKJob 
Command, 3~3 
IOA Screen Definition, 
Utility CTTCRDF, 9•113 
CTMDAILY Procedure, 
2•17 
CTTCTRC Utility 
3-16 
CTMTAPUL Procedure, 
Allocate/Format Trace 
DAREPMISDD 
3~25 
File, 9-114 
Statement, 4-24 
CTOALOCP Utility 
CTTDAY Procedure 
CTMDAS Program 
Back up Automation Log, 
New Day Procedure 
New Day Processing, 3~17 
5-11, 9-100, 
(CTT), 7-7 
CTMEDA Program 
CTOCSF Utility 
CTTDBDLD Utility 


New Day Processing, 3-17 
Copy Statistics File, 9•98 
LoadMDBand STK 
CTMFRCKP Utility 
Statistics File Size (CTO), 
Files, 9-115 
Active Jobs File Size, 9-4 7 
5-10, 
CTTDBill!JL Utility 


Restoring the Active Jobs 
CTOCSF J, Member 
Loading Files, 9-115 
File, 3-26 
Message Statistics, 9-98 
Unload MDB and STK 


CTMFRM Program, 3-10 
CTORSTM Utility 
Files, 9-116 
New Day Processing, 3-16 
Message Statistics 
Unloading Files, 9-116 


CTMILU Program 
Report, 9-99 
CTTDBF Utility 
/ \_;) 
New Day Processing, 3-16 
CTRXOOl Exit 
Format an Existing File, 
CTMILY Program 
Interface to CTT, 7-43 
9-117 
New Day Processing,.3-16 
CTT3495 Member 
CTTDBIB Utility 
CTMISCA Member, 3~34 
Interface to IBM Robot, 
Rebuild, Stacking 


CTMISCB Member, 3~34 
7-26 
Statistics Index, 9•118 


CTMISR Routine 
CTTACCDB Macro 
CTTDBID Utility 


Inter-System 
High Level API, 7-68 
Check Data File 
Communications (CTM), 
Return Codes, 7-70 
Integrity, 9-119 
3-35 
Wo11k Area, 7-69 
Rebuild Indices (CTT), 


CTMJOB Program 
CTTACP·Utility 
7-24 


Daily Processing (CTM), 
Copy Trace File, 9-106 
CTTDBII Utility 


3-18 
Trace File Size, 7-23 
Index File Integrity, 
New Day Processing, 3-17 
CTTADBP Macro 
9-120 


CTMJSA Utility 
Call' From CTTACCDB, 
CTTDBPRT Utility 


Job Statistics 
7-69 
Print Database Records, 
Accumulation,. 9-49 
Variables, 7-70 
9-121 


CTMLDNRS Maintenance 
CTTAFR Utility 
CTTDBTP Macro 
Job, 3-6 
Format/Initialize Trace 
Call From CTTACCDB, 


CTMLEVEL Macro, 2•47 
File, 9-108 
7-69 


CTMMMSG Macro, 2•4 7 
CTTARC Macro 
CTTDDX Macro 


CTMPr>A Program 
Trace File Mapping, 7-17 
Index Mapping,.7-13 


Daily Processing (CTM), 
CTTBIX Utility 
CTTDLD Utility 


3-18 
Media, 7-20 
Add/Delete/Convert 
New Day Processing,.3-17 
Rebuild Indices (CTT), 
Volumes, 9-122 


' 
CTMSBLK Macro 
7-24 
CTTDLX Macro 
f 
\ 
I 
I 
u 
IOA Screen Definition, 
Rebuild MDB Index, 
Index Mapping, 7-13 


2•17 
9-109 


IOA Rel. 5.0~0 Administrator Guide 
Index-9 


Index 


CTTDVX Macro, 
CTTRBXLC Report 
CTTRRCLV Report 
u 
Index Mapping, 7-13 
CTTRPT Utility, 9-155 
CTTRPT Utility, 9-154 
CTTFMDBJob 
CTTRCHKl Report 
CTTRRTNP Report 
CTTDBF Utility, 9•117 
CTTRPT Utility, 9•154 
CTTRPT Utility, 9-154 


CTTFSTKJob 
CTTRCLN Report 
CTTRSCRD Report 
CTTDBF Utility, 9-117 
CTTRPT Utility, 9-154 
CTTRPT Utility, 9-154 
CTTGVL Utility 
CTTRCV Utility 
CTTRSTK Member 


Stacking Interface, 9•125 
Database Recovery, 7-24 
StorageTekRobot 
CTTIDB Utility 
Examples, 9-142 
Support, 7-29 


Common Integrity Errors, 
MDB Recovery, 9-139 
CTTRTM Utility 
7-20 
Return Codes, 9•142 
Condition Codes, 9-170 


MDB Integrity, 7-19; 
Selective Recovery, 7-25 
Examples,.9-171 
9-127 
CTTRDCRE Report 
New Day Procedure 
New Day Procedure 
CTTRPT Utility, 9•154 
(CTT), 7-8 
(CTT), 7-9 
CTTRDELV Report 
Parameters, 9-166 
CTTINIT Procedure 
CTTRPT Utility, 9-154 
Retention Management, 


CTTPARM Modifications, 
CTTRDUPD Report 
9-162 
7-4 
CTTRPT Utility, 9-155 
CTTRUTIL Report 
Description, 7-2 
CTTREDM Repo11t 
CTTRPT Utility, 9 ... 154 
Parameters, 7-2 
CTTRVBOX Report 


Starting CONTROil-T, 
CTTRPT Utility, 9-154 
CTTRPT Utility, 9-155 
7-2 
CTTRFSCR Report 
CTTRVUPD Report 


CTTIOS Macro 
CTTRPT Utility, 9~154 
CTTRPT Utility, 9-155 


API Access of MDB, 7-4 7 
CTTRINV Report 
CTTRWDCP Report 
\ 
Format, 7-48 
CTTRPT Utility, 9-154 
CTTRPT Utility, 9-154 
u 


Invocation Form, 7-50 
CTTRINVT Report 
CTTSPL Utility 


Reason Codes, 7-49, 7-71 
CTTRPT Utility, 9-154 
CTTMER Utility, 9-129 
Return Codes, 7-51, 7-71 
CTTRLACV Report 
Extract MDB Info, 9-172 
CTTMER Utility 
CTTRPT Utility, 9•154 
CTTSTK Utility 


Merge Records, 9•129 
CTTRLA VJ Report 
Build/Update STK File, 
CTTMMRX Member 
CTTRPT Utility, 9-154 
9-177 


MEMOREX TELEX 
CTTRLRTV Report 
New Day Procedure 


Support, 7-32 
CTTRPT Utility, 9-154 
(CTT), 7-8 


CTTMUP Utility, 9 ... 131 
CTTRMlOV Report 
Trace Mode, 7-41 
Examples, 9-138 
CTTRPT Utility, 9•154 
CTTTCT Macro 
Field Names,.D-1 
CTTRM25L> Report 
Control Table, 7 -45 
Field/Value Specification, 
CTTRPT Utility, 9-155 
CTTTLD Routine 
9-136 
CTTRMACV Report 
Load the Control Table, 
Manual Update of the 
CTTRPT Utility, 9 ... 154 
7-45 
MDB, 7-21 
CTTRM0VW Report 
CTTTPI Utility 


Media Database 
CTTRPT Utility, 9-154 
Activation, 9o.l82 


Integrity, 7-20 
CTTRNRTR Report 
Examples, 9-191 
Return Codes, 9-137 
CTTRPT Utility, 9•155 
Invoking, 9-190 
CTTPARM Member 
CTTROUTL Report 
Return Codes, 9•191 


Modification via 
CTTRPT Utility, 9-154 
StorageTekRobot 
CTTINIT, 7-4 
CTTRPT Utility 
Support, 7-30 
CTTRBMStep 
Report Generation, 9-143. 
Tape !nit/Erase/Mapping, 


CTTRTM/GTTVTM 
Return Codes, 9-153 
9-179 
u 
Procedure, 7-28 
Sample Reports, 9-154 
CTTTPICT DB Statement 
CTTTPI Utility, 9-190 


Index-10 
IOA Rel 5.0;0 Administrator Guide 


Index 
u 
CTTTPITP DD Statement 
-D- 
CONTROI!,-D Monitor, 
4-32 
CTTTPI' Utility, 9•190 
D Parameter 
Migration Skeleton, 4-57 
CTTTRB Utility 
I0ADBF Utility, 9-18 
Restore Mission, 4-64 
Backup.MDB and Trace 
D37 Abend 


DADlJJMP DD Statement 
File, 9-192 
Global AutoEdit Library, 
Archive Server 
CTTUDB Utility 
5-14 
Procedure, 4-73 
Update MDB, 9•193 
DAALOCIN DD Statement 
CMEM Procedure, 3-31 
CTTVTM Utility 
Dynamic File Allocation, 
CONTRO!i,-0 Procedure, 
Examples, 9-199 
4-29 
5-17 
New Day Procedure 
DAALPPRM DD Statement 
DAFILE DD statement 
(CTT), 7-8 
Utility CTOALOCP, 
IOADBF Utility, 9-18 
Return Codes, 9-199 
9-100 


Vault Management, 9-194 
DAALTALC D:ID Statement 
DAFRMIN DD Statement, 
3-11 
CTTX002 Exit 
Allocation Customization,. 
New Day Procedure 
Stacking Facility, 7-40 
2'-12 
CTTX010 Exit 
DAAMF DD Statement 
(CTM), 4-29 
DAGENLST D:ID Statement 
Stacking Algorithm, 7-40 
CTDRRQ Program, 4-28 
Generic Decollating, 4-14 
CTVCLMIG Utility 
DAAPA DD Statement 
DAGENUSR DD Statement 
Clean Migrated. Report 
AFP Control Parameters, 
CTDRRQ Program, 4-28 
List, 9-93 
4-40 


Description, 4-77 
DABKPLST DB Statement 
Generic User List, 4-22 


CTVDELI Utility 
Backup Missions, 4-14 
DAGLBLST DD Statement 


Deleting DASD Index 
Migration Missions, 4-14 
Global Variables, 5-12 
Daily Checkpointing, 3-8 
Files,. 9•94 
DABRULE DD Statement 
Daily Processing 


( 
· .. 
Customization. See also 
CTB Rule Libraries, 6-4 
v 


Description, 1-6 
Modification· 
DACHK Dil Statement, 
Daily Subsystem. See New 
Allocation of Files, 2-11 
3-13, 4-8 


Color Support, 2-26 
CTBNDAY Procedure, 6-2 
Day Procedure 
Commands, C-1 
CTMDAILY Procedure, 
DAILYPRD Job 
Display Format Member, 
4-24 
Sample User Daily, 3-6, 
2-19 
DACOFPRM DD Statement 
3-13 
Exit CTDX005, 4-49 
CTDCAMF Utility, 9-68 
DAILYSYS Job 


Sample User Daily, 3-6, 
IOA Messages,. 2.:.4 7 
Utility CTMCAJF, 9-45 
3-13 
IOA Profiles, 2-32 
DACRSIN DD Statement 
DAISCNn DD Statement 
IOA Screens, 2-17 
IOACLRES Utility, 9-7 
Inter-System 
Limited Access to IOA 
DACTMLST DD Statement 
Communications (CTM), 
Products, 2-8 
CMEM Rule List, 5-25 
3-34 
Online Facility, 2'-8 
Rule Table List (CMEM), 
DAJOB DD Statement,.3-13 
PFKeys, 2.:.13 
3-27, 5-3 
DALCPPRM DD Statement 
Primary Option Menu, 
DADJDE DD Statement 
Utility IOACPLOG, 9•16 
2.:.15 
Printers Control Monitor, 
DALNRIN DD Statement 
Screen Definition, 2-34 
4-42 
New Day Procedure (CTM 
CUSTOMIZE Option 
DADJOB DD statement 
& CTD)), 4-29 
IOA Installation Menu, 
Backup Missions, 4-55 
DALOG DD Statement 
2-36 
Migration Library, 4-58 
CTDRRQ Program, 4-28 
CYCLECNT Parameter 
Restore Mission, 4-65 
CTTTPI Utility, 9-190 
CTTPARM, 9-194 
DADSKL DD Statement 
Utility CTMBGRP, 9•43 
CTTPARM Member, 
Backup Mission, 4-54 
Utility IOACPLOG,. 9-16 
(_j 
9-164 
Backup Missions, 4-55 
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DALOGCUR DD Statement 
Media Database, 7-10' 
Date Format 
u 
Utility IOACPLOG, 9-16 
Printing (CTT), 9-121 
INCLUDE/EXCLUDE 
DALOGSEQ DID Statement 
Stacking Statistics File, 
Statements, D-1 


Copy IOA Log,.9-16 
7-18 
Profile Variable, 2-40 


DAMDB DD Statement 
Data File Parameters 
DATE Keywol'd 
CTTTPl Utility, 9-190 
CTTCRDF Utility, 9-111 
Trace Record, D-11 
Media Database, 7-9 
CTTCTRC Utility, 9•114 
DATE Parameter 
DAMDI DD Statement 
DATA Parameter 
CTDCCU Utility, 9-74 


CTTTPI Utility, 9•190 
@FIELD Display Format 
CTTRTM Utility, 9•166 


Media Database, 7-9 
Line, 2'-22 
CTTVTM Utility, 9-195 


DAOBT DD Statement 
@HEADER Display 
Date Range 


CTDRRQ Progl'am, 4-28 
Format Line, 2•21 
IOA Log, 9•16 
DAOVRALC DD Statement 
@VAL Display Format 
Profile· Variable, 2-42 
Allocation Customization, 
Line, 2-23 
DATEREC 


2~12 
CTTIOS Macro, 7-49 
Date Control Record 


DAPOOLS DD Statement 
Database ( CTT) 
(CTM), 3-6 


CTTINIT Procedure, 7-3; 
Printing, 9•121 
DATERECU 


7-5 
Database Utilities 
Date Control Record 


DAPROG DID Statement 
CONTROL-T, 9•6 
(CTM), 3~6 


New Day Processing 
Dataset 
DATRC DI!> Statement 


(CTM), 3-16 
Multi-Volume, 7-15 
CTTTPI Utility, 9-190 
DAPRTLST DI!> Statement 
Dataset Allocation 
DAVLTS DB Statement 
Printing Missions, 4-14 
Utility CTTGVL, 9-125 
CTTINIT Procedure, 7-3, 


DAREFIN DD Statement 
Dataset Length 
7-5 
l~ 
Utility CTORSTM, 9~99 
Stacking Facility, 7-40 
Daylight Savings Time 


DAREPLST DID Statement 
DATASET Parameter 
Clock Changing, 3-23 
Decollating Missions, 
CTTGVL Utility, 9-125 
DAYS Parameter 
4-14 
Dataset Record 
CTBJAFDL Utility, 9-65 


DAREPMIS DD Statement 
Index File, 7-13 
DAYS Statement 
Decollating Mission 
Keywords, D-2 
CTDDELRP Utility, 9-80 


Library, 4-24 
Media Database, 7-10' 
CTVDELI Utility, 9•95 


Decollating Missions 
Volume Record, 7-13 
DAYTIME Parameter 
Library, 4-23: 
Date 
Modification (CTT), 7-4 


DARSTLST DD Statement 
Printing Mission 
DBABFB Parameter 
Restore Missions, 4-14 
Scheduling, 4-34 
CTBFRM Utility, 9-62 


DARULLST DD Statement 
Date Control Record 
DBBKPB Parameter 


CTO Rule List, 5-25 
Checkpointing, 3~8 
CTBFRM Utility, 9-62 


CTTINIT Procedure, 7-3, 
CONTROI.:.-B, 6-2 
DBFILE Parameter 
7-5 
Creation (CTM), 3-14 
CTBDBIB Utility, 9-52 
Loading Rules (CTO), 5-2 
Decollating Scheduling 
IOADBSR Utility, 9-25 
DASD 
(CTD), 4-14 
IOADIG Utility, 9-29 
Deleting Index Files, 9-94 
Format (CTB), 6-3 
IOADII Utility, 9-30 
Disaster Recovery, 7-24 
Format (CTM), 3~14 
lOADPT Utility, 9~32 
DASORTPR DID Statement 
Format CTD, 4-7 
IOADUL Utility, 9-33 
Active User Report 
General 1 Daily (CTD), 
DBFILEB Parameter 
Sorting, 4-83 
4-10 
Utility CTBABI, 9-50 
Data Extraction 
User Daily Job (CTM), 
DBFILEl Parameter 
Media Database, 9-143 
3~4, 3-17 
CTTDBDLD Utility, 
\ 
Data File 
9-115 
\._! 


Fields, 7 -18 
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u 
CTTDBDBL Utility, 
DBUNITT Parameter 
DDSDEN Keyword 
9-116 
CTTCRDF Utility, 9-111 
Dataset Record, D-3 
DBFILEO Parameter 
CTTCTRC Utility, 9"114 
DBSDSN Keyword 
CTTDBDLD Utility, 
DBVERT Parameter 
Dataset Record, D-4 
9•115 
CTTCRDF Utility, 9-111 
Trace Data, D-12 


CTTDBDl!JL Utility, 
CTTCTRC Utility, 9-114 
DDSEFTG Keyword 
9-116 
DBV01;,T Parameter 
Dataset Record, D-3 
DBFILET Parameter 
CTTCRDF Utility, 9-111 
DDSEXCP# Keyword 
CTTCRDF Utility, 9•111 
DCF 
Dataset Record, D-3 
CTTDBF Utility, 9-117 
IBM word processor, 4-40 
DDSEXPDl Keyword 
CTTDBIB Utility, 9-118 
DCHANGED Keyword 
Dataset Record, D-3 · 
CTTDBID Utility, 9-119 
Dataset Record> D-2' 
DDSEXPTl Keyword 
CTTDBII Utility, 9-120· 
DCHANGET Keyword. 
Dataset Record, D-3 
CTTDBPRT Utility, 9-121 
Dataset Record, D-2 
DDSFEET Keyw.ord 
Media Database, 7-21 
DCHANGEU Keyword 
Dataset Record, D-3 
Trace File, 7-22 
Dataset Record, D-2 
DDSFLG 1 Keyw.ord 
DBGJOB Parameter 
DD Statements 
Dataset Record, D-3 
CTTINIT Procedure, 7-5 
CTTINIT Procedure, 7-5 
DilSJEXPD Keyword 
DBGLEVEL Parameter 
DDNAME Parameter 
Dataset Record, D-4 
CTTINIT Procedure, 7-5 
CTTTPI' Utility, 9"187, 
DDSLACS Keyword 
CTTMERUtility, 9-130 
9•188 
Dataset Record, D-4 
CTTRTM Utility, 9-166 
DDSACCT Keyword 
DDSLBLNM Keyword 
CTTSPI:. Utility, 9-175 
Dataset Record, D-2 
Dataset Record, D~4 
u 


CTTVTM Utility, 9-195 
DDSBLK Keyword 
DDSLUSER Keyword 
DBGLVL Parameter 
Dataset Record, D-2 
Dataset Record, D-2 
CTTIOS Macro, 7-49 
DDSBLKC Keyword 
DDSMDT Keyword 
DBJAFB Parameter 
Dataset Record, D-2 
Dataset Record, D-2 
CTBJAFDL Utility, 9-65 
DDSCCC Keyword 
DilSMTM Keyword 
DBJAFI Parameter 
Dataset Record, D-2· 
Dataset Record, D-2 
CTBJAFCP Utility, 9-63 
DDSCCPl:J Keyword 
DIDSRBA Keyword 
DBJAFO Parameter 
Dataset Record, D-2 
CTTMUP Utility, 9-133 
CTBJAFCP Utility, 9-63 
DDSCDIDN Keyword' 
Trace Data, D-12 
DBFREFA Parameter 
Dataset Record, D-2 
DBSRCC Keyword 
IOADBSR Utility, 9-25 
DDSCDT Keyword 
Dataset Record, D-4 
DBPREFT Parameter 
Dataset Record, D-2 
DDSRCPU Keyword 
CTTCRDF Utility, 9-111 
DDSCJBN Keyword 
Dataset Record, D-4 
CTTCTRC Utility, 9-114 
Dataset Record, D-2 
DBSRDDN Keyword 
Media Database, 7-21 
DDSCJID Keyword 
Dataset Record, D-4 
Trace File, 7-22 
Dataset Record, D-2 
DDSRDT Keyword 
DBREFB Parameter 
DDSCPGM Keyword 
Dataset Record, D-4 
CTBJAFDI;. Utility, 9-65 
Dataset Record,.D-2 
DBSRECFM Keyword 
DBREPI Parameter 
DDSCSTP Keyword 
Dataset Record, D-5 
CTBJAFCP Utility, 9-63 
Dataset Record, D-2 
DDSRECL Keyword 


DBREFO Parameter 
DDSCTM Keyword 
Dataset Record, D-4 
CTBJAFCP Utility, 9-63 
Dataset Record, D-2 
DDSRJBN Keyword 
DBSRTPRM DD Statement 
DDSCUAD Keyword 
Dataset Record, D-4 
Active User Report 
Dataset Record, D-2 
DDSRPGM Keyword 
u 
Sorting, 4-83 
DDSCUSER Keyword 
Dataset Record, D-4 
Dataset Record, D-2 
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DilSRSTP Keyword 
Generic Processing 
Deleting. See also Erasing. 
u 


Dataset Record, D-4 
(CTD), 4-4 
See also Cleaning 
DDSRTM Keyword 
VTAM Monitor, 2~8 
CDAM Files, 9-74 
Dataset Record, D-4 
Deactivation 
CTB Variables,. 9-59 


DDSRTORG Keyword 
CONTROL-0, 5.1 
DASD Index Files, 9"94 


Dataset Record, D-5 
DEBUG Command 
MDB Volume, 9-132 


DDSRTYPE Keyword 
CMEM, 3-31 
Prerequisite Conditions, 
Trace Data, D-12 
CONTROL-0, 5-17 
9-7 


DBSRUAD Keyword 
Debugging 
Reports (CTD), 9-79 


Dataset Record; D-4 
Archive Server, 4-73 
Rule Activity File, 9-65 


DDSSMCI.:. Keyword 
CMEM Rules, 3~30 
Rule Table (CTO), 5-5 


Dataset Record, D-5: 
CONTROL-0, 5-16 
Unneeded Jobs, 9-47 


DDSSTAT Keyword 
Job Name (CTT), 7-5 
Volumes from MDB, 


Dataset Record, D-4 
DECFROM Parameter 
9-122 


DDSTRTCH Keyword 
Utility CTDUPBKP, 9-88 
Deletion Rules 


Dataset Record, D-5 
DECOLLATED Status 
Utility CTDDELRP, 9-82 


DDSUSED Keyword 
Active User Report List, 
DELGR Parameter 


Dataset Record, D-4 
4-77 
CTBDBVDL Utility, 9-59 


DDSUSER2 Keyword 
Decollating Mission 
DELVOL Function 


Dataset Record, D-4 
CONTROL-B Rule, 6·9 
High Level AP!', 7-68, 


DDSVOLS# Keywo11d 
Generic, 4-19 · 
7-69 


Dataset Reco11d; D-5 
Profile Variable, 2-36 
DELYBLK Parameter 


DDSVOLSR Keyword 
Scheduling, 4-13 
IOADBSR Utility, 9-26 


Dataset Record, D-4 
Decollation Mission 
DEN Parameter 
u 
DDSWCC Keyword 
Overview, 4-19 
Exit CTDX005, 4-51 


Dataset Record, D-5 
DECTO Parameter 
DENSITY Keyword 


DBSWCPli Keyword 
Utility CTDUPBKP, 9-88 
Dataset Record, D-3 


Dataset Record; D-5 
Dedicated· Device Mode 
Dependency 


DDSWDDN Keyword 
CART Media, 4-67 
CTM Job·and CTD 


Dataset Record, D-5 
DEFABEND Parameter 
Report, 4-25 


DDSWDT Keyword 
Modification (CTT), 7-4 
DESC Parameter 


Dataset Record, D-5 
Default. See also specific 
Automation Option• 


Menu, 5-19 


DBSWJBN Keyword 
variable, parameter, or 
function 
IOATEST Utility, 9-39 
Dataset Record, D-5 
DEFAULTEDIT Parameter 
DEST JES2 Parameter 


DDSWPGM Keywo:rid 
@FIELD Display Format 
Multi-Chunk Printing, 
Dataset Record~ D-5 
Line, 2'-23 
4-35 


DDSWSTP Keyword 
DEFDELAY Parameter 
Destination Table. See 
Dataset Record, D-5 
IOATEST Utility, 9-39 
Dynamic Destination Table 


DDSWTM Keyword 
DEFER Parameter 
DETAIL Parameter 


Dataset Record, D-5 
Exit CTDX005, 4-51 
CTDlJPBKP Utility, 9-90 


DBSWUAD Keyword 
DEFEXPDT Parameter 
DEVADBR Parameter 


Dataset Record; D-5 
Modification (CTT), 7-4 
CART Media, 4-67 


Deactivating 
DEFGRP Member, 2~30 
Migration Media, 4-59 


Archive Server (CTV), 4-5 
DEFGRPI Member, 2'-30 
Device Definition 


CDAM, 4-5 
DEFHST Member, 2'-30 
CART Media, 4-67 


CMEM Monitor, 3-3 
DEFHSTI Member, 2-30 
DEVICE Parameter 


CMEM Rule Table, 3~28 
DEFSTAT Member 
MEDIA Operator 
u 
CONTROL-M Monitor, 
Message Statistics, 9-98 
Command, 4-69 


3~1 
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DEVQTY Parameter 
DM0D Parameter 
DSNAME Keyword 
CART Media, 4-67 
CTBDBVDL Utility, 9-59 · 
CTTMUP Utility, 9-134 


MEDI~ Operator 
DMS/OS Support 
Dataset Record, D-4 
Command, 4-70 
Backup Utility, 4-55 
Trace Data, D-12' 


DF/DSS 
DD Statements, 7-36 
DSNDEL Statement 
Backup Utility, 4-55 
External Data Manager, 
CTTMUP Utility, 9-134 


DF/FISM 
7-35 
DSNMCHK Parameter 
Backup Utility, 4-55 
DOCDPAGM Member 
Modification (CTT), 7-4 


DF/SMS Support, 7-37 
AFP Printing, 4-40 
DSNPREF Parameter 
DFLT Parameter 
DOGRP Parameter 
Dual Migration, 4-59 
@FIELD Display Format 
CTBDBVCP Utility, 9-56 
Migration Media, 4-59 
Line, 2-23 
DOLV. See also Online 
DSNUPD Statement 
DGRP Parameter 
Viewing 
CTTMUP Utility, 9-133 


CTBDBVDL Utility, 9-59 
DOMOD Pavameter 
DSNUPDN Statement 
DIGRP Parameter 
CTBDBVCP Utility, 9-56 
CTTMUP Utility, 9-134 


CTBDBVCG Utility, 9-54 
DORM Mode 
DSSTAT Keyword 


CTBDBVCP Utility, 9-56 
CTTINIT Procedure, 7-4 
Dataset Record, D-4 


DIMOD Parameter 
Dormant Mode 
DSUSECT Keywo11d 
CTBDBVCG Utility, 9-54 
CONTROl!.-T, 7-4 
Dataset Record, D-4 


CTBDBVCP Utility, 9-56 
Double Byte Character Set 
DSVOLSER Keyword 
Disaster Recovery 
Profile Variable, 2-45 
CTTMUP Utility, 9•133, 


Media Database, 7-24 
DOV AR Parameter 
9-134 
Disk 
CTBDBVCP Utility, 9•56 
Dataset Record, D-4 
u 


Migration Skeleton, 4-60 · 
Driver Exit 
D-type Index 
Display. See also Screens 
CONTROL-R, 7-43 
Media Database, 7-13 
Media/Resource 
DSDELL Statement 
Dual Checkpoint Mode 
Information, 4-72 
CTTMUP Utility, 9-134 
CONTROL-M Monitor, 


DISPLAY Command 
DSENDFET Keyword 
3-26 
Active Users, 2'-6 
Dataset Record, D-3 
Dual Migration (CTV), 4-59 


CMEM, 3-29 
DSEXCP Keyword 
Dual Mirror Image File 
Display Format Member 
Dataset Record, D-3 
Recovery, 9-27 
Customization, 2'-19 
DSEXPDT Keyword 
Support, 2•30 


Format, 2'-20 
Dataset Record, D-3 
DUAL Parameter 
DISPLAY Parameter 
DSEXTYP Keyword 
IOADBF Utility, 9-20 


IOA VERFY Utility, 9-41 
Dataset Record, D-3 
DUALM Parameter 
Display Type Editing. See 
DSFEET Keyword 
IOA Access Method, 2-31 
Display Format Members 
Dataset Record, D-3 
IOADBF Utility, 9•20 


Distribution Report 
DSFLAGS Keyword 
DUALST Parameter 


CTTVTM Utility, 9-194 
Dataset Record, D-3. 
IOA Access Method, 2-31 


DIVAR Parameter 
DSLABEL Keyword 
IOADBF Utility, 9•21 
CTBDBVCG Utility, 9-54 
CTTMUP Utility, 9-133, 
D'NMMY Parameter 


CTBDBVCP Utility, 9-56 
9-134 
Exit CTDX005, 4-51 
DJDE Parameters 
Dataset Record, D-4 
DUSRDATA Keyword 
XEROX Printers, 4-42 
DSN Parameter 
Dataset Record,.D-4 
DJDE Printing. See also 
Exit CTDX005, 4-50 
DVAR Parameter 
XEROX 
IOADBF Utility, 9-19 
CTBDBVDL Utility, 9-59 
DJDEPARM Library 
DSNADD Statement 
DVLACTD# Keyword 


I 
Format, 4-42 
CTTMUP Utility, 9-134 
Volume Record, D-6 
v 
XEROXDJDE 


Parameters, 4-42 
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DVLADT Keyword 


Volume Reco11d, D-6 


DVLATM Keyword 


Volume Record, D-6 


DVLBOXID Keyword 


Volume Record, D-6 


DVLCLN Keyword 


Volume Record, D-6 


DVLCLN# Keyword 


Volume Recol'd, D-6 


DVLCODE Keyword 


Volume Record, D-6 


DVLDEN Keywol'd 
Volume Record, D-7 


DVLDESC Keyword 


Volume Record, D-9 
DVLEDMID Keyword 


Volume Record, D-8 


DVLEXCP# Keyword 


Volume Record, D-8 
DVLEXPD Keyword 


Volume Record, D-8 


DVLEXPDS Keywol'd 
Volume Record, D-6 


DVLEXPT Keyword 


Volume Record, D-8 


DVLFCDT Keyword 


Volume Record, D-6 
DVLFEET Keyword 


Volume Recol'd, D-8 


DVLFIRST Keyword 


Volume Record, D-6 


DVLFLG 1 Keyword 


Volume Record, D-8 
DVLFLG2·Keyword 


Volume Record, D-9 


DVLJBN Keyword 


Volume Record, D-6· 


DVLLBLNM Keyword 


Volume Record, D-6 
DVLLDFTG Keywo11d 
Volume Record, D-6 


DVLLTYP Keyword 


Volume Record, D-6 


DVLMDT Keyword 


Volume Record, D-7 
DVLMEDIA Keyword 


Volume Record, D-7 
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DVLMTM Keywo11d 
Volume Record, D-7 


DVLMVDT Keyword 


Volume Record, D-7 


DVLNEXT Keyword 


Volume Record, D-7 


DVLOWNR Keyword 


Volume Reco11d, D-9 


DVLPREV Keyword 


Volume Record, D-7 


DVLFRFLN Keyword 


Volume Record, D-8 


DVLRBA Keyword 


CTTMUP Utility, 9"132 


Trace Data, D-12 
DVLRFEET Keyword 


Volume Record, D-7 


DVLRPER Keyw.ol'd 
Volume Recol'd; D-6 


DVLRPERC Keyword 


Volume Record, D-6 


DVLRTER Keywo11d 
Volume Record, D-6 


DVLRTERC Keyword 


Volume Reco11d, D-6 


DVLRTRN Keyword 


Volume Record, D-6 
DVLRTYPE Keyword 
Trace Data, D-12 


DVLSCRDT Keyword• 
Volume Record, D-7 


DVLSLNAME Keywol'd 
Volume Reco11d, D-7 


DVLSTA2 Keywol'd 
Volume Record, D-9 


DVLSTAT Keyword 


Volume Record, D-9 


DVLTRTCH Keyword 


Volume Recol'd> D-9 


DVLUNAM Keyword· 
Volume Recol'd, D-7 


DVLUSED# Keyword 


Volume Record, D-9 


DVLUSER Keyword 


Volume Record, D-7 


DVLUSER2 Keyword' 


Volume Record, D-7 


DVLVENDT Keyword 


Volume Record, D-7 


DVLVLTl Keyword 


Volume Record, D-7 


DVLVLTDS Keyword 


Volume Record, D-7 


DVL VLTNM Keyword 


Volume Record, D-7 


DVLVLTRC Keyword 


Volume Record, D-7 


DVL VL TT Keyword 


Volume Record, D-7 


DVL VNDOR Keyword 


Volume Record, D-7 


DVLVOLSR Keyw.ord 
Trace Data, D-12 


Volume Record, D-9 
DVL VRTRN Keyword 


Volume Reco11d, D-7 


DVLVSEQ Keyword: 


Volume Recol'd, D-9 


DVLVSLOT Keyword 


Volume Record, D-7 


DVL VTSQ Keyword 


Volume Record, D-7 


DVLVXPDl Keyword 


Volume Record, D-8 


DVL VXPTl Keyword 


Volume Record, D-8 


DVLWPER Keyword 


Volume Record, D-6 


DVLWPERC Keyword 


Volume Record, D-6 


DVLWTER Keyword 


Volume Record,. D-6 
DVL WTERC Keyword 


Volume Record, D-6 
Dynamic Dataset Stacking. 


See Stacking Facility 
Dynamic Destination Table, 
2-49 
Description, 1-11 
Dynamic Device Mode 


CART Media, 4-67 
Dynamic Sorting 


Active Report List, 4-83 


DYNDEVRLSE Parameter 


CART Media, 4-67 


DYNDS Parameter 
Modification (CTT), 7-4 
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( u 
DYNSTYP Parameter 
ENV Parameter 
ExLM 
Modification (CTT), 7-4 
CTTIOS Macro, 7-49 
StorageTek Silo Support, 
DYNVOL Parameter 
Environment. See Online 
7-31 
Modification (CTT),. 7-4 
Facility 
EXLMJOB Member 
DYNWTO Parameter 
I0A Online, 2~1 
ExLM JCL, 7-32 


HSC/CSC Scratch 
Program List Member, 
EXLMSAMP Member 


Support, 7-31 
2-10 
ExLM Control 
ERASE Parameter 
Statements,. 7-32 
-E- 
CTTTPI Utility, 9-187 
Expanding 


ERASELBL Parameter 
Conditions/Resources 


EDIMACNM Profile 
CTTTPI Utility, 9-188 
File, 2-49 
Variable 
Erasing 
IOA LOG File, 2-50 


Editing JCL, 2-46 
Information on a Tape, 
EXPDSNUM Keyword 
EDIT Parameter 
9-181 
Volume Record, D-6 
@FIELD Display Format 
Error. See also Integrity. 
EXPDT Parameter 
Line, 2-23 
See also Abend 
Exit CTDX005, 4-51 
CTTRPT Utility, 9-148 
Media Database 
EXPDTDDN 
EMASS 
Integrity, 7-19, 9-127 
Modification, (CTT), 7-4 
Tape Library Support, 
Error Handling 
EXPilTYPE Parameter 
7-32 
High Level API (CTT), 
CTTPARM Member, 
ENABLE Parameter 
7-70 
9•164 
IOADBSR Utility, 9•25 
Error Message. See 
Modification (CTT), 7-4 
END Function 
Message or Messages 
Expert Library Manager. 
High Level API, 7-68, 
Exception Handling 
See ExLM 
u 


7-69 
Backup Missions, 4-56 
EXPRTRN Keyword 
END Parameter 
Migration Missions, 4-62 
Volume Record,.D-6 
IOA VERFY Utility, 9-42 
Restore Mission, 4-65 
EXTEND Parameter 
ENDDATE Parameter 
EXCLUDE Statement. See 
IOADBF Utility, 9·21 
Utility CTOALOCP, 
also INCLUDE/EXCLUDE 
Extended Color Support, 
9-100 
Statements 
2-25. See also Color 


ENDED Status 
EXCLUDE Statements 
Support 


Backup.Mission, 4-56 
Format (CTT), 9-103 
Profile Variable, 2-45 
Migration Mission, 4-62 
Record Selection (CTT), 
External Data Manager 
ENDTIME Parameter 
9-102 
CA-ASM2Support, 7-36 


Utility CTOALOCP, 
EXEC Statement 
CONTROL-T Support, 
9-100 
CTTTPl Utility, 9-182 
7-35 


ENDBPD Statement 
Execution Parameters 
DF/SMS Support, 7-37 


CTTMUP Utility, 9-135 
ACIF Interface, 4-44 
DMS/OS Support, 7-35 
Enhanced Daily 
Exits.See also User Exit 
HSM Suppoiit, 7-35 
Checkpointing 
CTDXOOl, 4-17, 4-23, 
External Resources 
(CTD), 3-8 
4-28 
Saving via ACIF, 4-44 
(CTM), 3-18 
CTDX009, 4-33 
Extract File 
Enlarging 
CTDXOiJ.O, 4-55, 4-58 
CTTMER Utility, 9-129 
Media Database, 7-21 
CTDXOll, 4-65 
EXTRACT PATH 


Trace File, 7-22 
CTRXOO 1, 7-43 
Statement 


ENQ Mechanism, 4-33 
CTTX002, 7-40 
CTTRPT Utility, 9-144 
Enqueue Manager 
CTTXOlO, 7-40 
EXTRACT Statement 
CONTROb-0, 5-7 
IGXMSGEX, 7-33 
CTTSPL Utility, 9-174 


(_j 
ENVKeyword 
IOAX007, 3-33 
EXTRNVOL Parameter 
Trace Record, D-11 
Modification (CTT), 7-4 
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-F- 
FOB Parameter 
FROM Parameter 
\~ 


Fat-DASD 
Exit CTDX005, 4-51 
CTMCAJF Utility, 9-46 


Migration Skeleton, 4-60, 
Fonts 
CTTACP Utility, 9-106 


4-61 
AFPDS Printing, 4-43 
CTTDBPRT Utility, 9-121 


FDR 
FORCE Parameter 
FROMDATE Parameter 


Backup Utility, 4-55 
CONTRO!J-0 Procedure, 
Utility CTMJSA, 9-49 


Field Names 
5-2 
Utility IOACPLOG, 9-16 


CTT Repository, D-1 
CTBFRM Utility, 9•62 
FROMDSN Parameter 


Dataset Records, D-2 
CTDilELRP Utility, 9-80 
Utility CTOALOCP, 


Stacking Records, D-10 
CTTRCV Utility, 9• 141 
9-100 


Trace Data, D-12 
Mission Scheduling, 4-15 
FROMGEN Parameter 


Trace Records, D-11 
Form Definitions 
CTBDBVCP Utility, 9-57 


Volume Records, D-6' 
AFPilS Printing, 4-43 
FROMKEY Parameter 


FIELD Parameter 
FORMAMF Member, 9-69 
IOADUL Utility, 9-33 


CTTRPT Utility, 9•148 
FORMAT Parameter 
FROMREC Parameter 


FIELDS Statement 
Automation Option 
CTTRCV Utility, 9-140 


CTTRPT Utility, 9-146 
Menu, 5-23 
FROMTYPE Parameter 


CTTRTM Utility, 9·170 
FORMATF Member 
Utility CTOALOCP, 


CTTVTM Utility, 9•197 
INSTCTD Library, 9•70 
9-100 


File 
Formatting 
FSET Parameter 


Allocation (CTT), 9-111 
Access Method' Variable 
FileTek Migration, 4-61 
File (CTB), 9-24 
FUNC Parameter 
Creation (CTT), 9-111 
Active Balancing File, 
IOADBF Utility, 9-18 
Expanding (CTM),.3;.35 
9•24 
IOADIG Utility, 9-29 
\_) 
Formatting (CTT), 9-111 
Automation Options, 5·23 
IOADPT Utility, 9-32 
File Allocation' 
Backup File (CTB), 9-24 
FUNCTION Keyword 
IOA Access Method, 2:.28 
CTB Files, 9-24 
Trace Data, D-11 
File Definition 
CTT Files, 9•111, 9-117 
FUNCTION Parameter 
IOA Access Method, 2:.30, 
Group.File (CTB), 9-24 
CTTSPL Utility, 9-174 
9-19 
FILE Parameter 
Online Facility, E-1 
Funtional Monitor 


CTBJAFCP Utility, 9•63 


Report File (CTB), 9•24 
Trace File (CTT),.7-17 
Rule Activity File (CTB), 
Utility CTBJAFIG, 9-67 
9-24 


Utility CTDUPBKP, 9-88 
Trace File (CTT), 9•108, 
-G- 
File Structure 
9-114 
GDDM 
IOA Access Method, 2'-27 
FORMCKP Member 
AFP Documents,.4-40 
FileTek Storage Machine 
Active Jobs File Size, 
GDG. See Generation Data 
Logical Devices, 4-70 
9-48 
Groups 
Media Definition, 4-68 
FORMDEF Parameter 
GENCLAS Parameter 
Migration Skeleton, 4-60; 
AFP Printing, 4-38 
Generic Decollating, 4-20 


4-61 
CDAM, 4-39 
GENER Parameter 
FileTek Storage Machine 
FREE Parameter 
CTDNPBKP Utility, 9-89 
Machine 
Printing Mission, 4-32' 
General Daily. See New 
Media Information, 4-73 
Free Space Chain, 
Day Procedure 
Finish Indicator Date 
Rebuilding (CTT), 7-24 
Date Control Record 


(CTD),.4-9 
Free Tape Pool 
(CTD),.4-10 
FIRST Parameter 
Utility CTDCLHIS, 4-79 
Generation Data Groups 


CTTDI:.D Utility, 9•123 
French 
Dataset Stacking, 7-42 
<J 
FIRSTVOL Keyword 
Language Support, 8-2' 
Generations 


Volume Record, D-6 
CTB Variables, 9-54 
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Generic Decollating 
Mission. See also 
Decollating Missions 
Overview, 4-19 
Scheduling, 4-21 
Generic Processing 
Activating,.4-1 
Generic User Name 
Definition, 4-22 


GENLIST Member 
Generic Decollating, 4-14 
German 
Language Support, 8-2 


GLBCOMP Parameter 
Global Library 


Compression, 5-15 


GLBPREF Parameter 
Global Variables (CTO), 


5-12 
Global AutoEdit Variable 
Library 
Automatic Compression, 


5-14 
Global Control 


Printing Characteristics, 
4-47 
Global Member 
Definition (CTO),. 5-13 
Global Profile, 2"32 


GLOBAL SMP/E Zone, 8-1 
Global Variables 
Description (CTO), 5-12 


Graphics 


AFPDS Printing, 4-43 
GRAU 
Tape Library Support, 


7-32' 


Group.File (CTB) 
Copying, 9-56 
Formatting, 9-24 
Rebuilding,. 9-24 


Group of Users 


CONTROL-D, 4-22 


GROUP· Parameter 


CTBDBVCG Utility, 9-54 


CTBDBVCPUtility, 9-56 


CTBDBVDL Utility, 9-59 
FileTek Media, 4-68 


IGNORE/SELECT 


Statements (CTM), 3-11 


Invoking CONTROL.-B, 
6·7 


Printing Mission 
Definition, 4-38 
Utility CTMBGRP, 9-43 
Group Scheduling Table 
Utility CTMBGRP, 9-43 


GROlJPPWD Parameter 
FileTek Media, 4-68 


GRPBIX Statement 


CTTMUP Utility, 9-133, 
9-136 


GRPSCR Statement 


CTTMUP Utility, 9-133 


-H- 


HDS Robots 


CONTROL-T Support, 
7-25 
Held Output Class (CTM), 


3-25 
Help Members 
Online Facility, E-1 
Hexadecimal 


AFP Parameters, 4-41 
High Level API (CTT) 


Base Level API, 7-46 
Buffer Address, 7 -69 
Description, 7-68 
Error Handling,.7-70 


Functions, 7-68 
Macro CTTACCDB, 7-68 
Macro CTTCHKDB, 7-70 
Sample JGL, 7-71 
Highlight. See also Color 
Support 


Display Format, 2"25 


HILITE Parameter 
Display Format Member, 
2-25 
HILITEA Parameter 
Display Format Member, 
2-25 
History Report List 


Cleaning, 9"76 
CTDCCU Utility, 9-74 


CTDDELRP Utility, 4-78, 
9-79 
Description, 4-78 
Restore Missions, 4-64 
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History User File 
Backup Utility, 9-87 
History User Report List 
Utility CTDCLHIS, 4-79 


HLDCLAS Parameter 
Held Output Class 
(CTM), 3~25 


Housekeeping. See 


Maintenance 


HSC Support 


StorageTek Robot, 7-28 


HSM Support, 7-35 


-1- 


IBM 


3480 Tape Cartridge 


Device, 4-70 
SMS Managed Tape 
Library, 7-26 
IBM 3390·9 


Migration Skeleton, 4-60 


IBM 3480 Tape. See also 


CART Media 
IBM 3995 
Migration Skeleton, 4-61 
IBM 3995 ·Optical Library 
Migration Skeleton, 4-60 


IBM Tape Library 


CONTROL-T Interface, 
7-26 
Tape Eject, 7-26 
Tape Entry, 7-27 


Use Attribute, 7-26 


User Exits, 7-26 


ICE 


Description, 1-2 


IOA Maintenance, 8-10 
Profile Customization, 
2-32 


Profile Variables, 2~35 
ICObOR 
Profile Variable, 2-45 
ID Parameter 


@STYLE Display Format 
Line, 2-20 
CTTRPT Utility, 9-146 
IDB CS 
Profile Variable, 2-45 
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IDLIKE Pa11ameter 
INCLUDE/EXCLUDE 
Information, Message. See 
u 
@STYLE Display Format 
Statements 
Message or Messages 
Line, 2~21 
CTBJAFCP Utility, 9-63 
INIT Mode 
IDM= 
CTBJAFDL Utility, 9-65 
CTTINIT Procedure, 7-3 


AFP Command, 4-41 
CTDCA2P Utility, 9-72 
INITIAL USE Attribute 


IDMS 
CTDCP2A Utility, 9-77 
IBM Robot Support, 7-27 


Color Suppo11t, 2"45 
CTDDELRP Utility, 9-79, 
Initialization 
ID MS/DC 
9-81 
CONTROI'..-D, 4-1 


Color Support, 2-25 
CTORSTM Utility, 9"99 
CONTROL.-M, 3-1 


IOA Online Support, 2"1 
CTTACP Utility, 9-106 
CONTROl!.-0, 5·1 
IEASYSXX Member, 2-6, 
CTTRCV Utility, 9-141 
CONTROL-T, 7-2 
4-4 
CTTRPT Utility, 9-145 
CONTROI!.-V, 4-1 
IEBGENER Utility 
CTTRTM Utility, 9•169 
Tape Initialization, 9-179 
Media Database Backup, 
CTTSPL Utility, 9-174 
Trace File, 9•108 


7-9 
CTTSTK Utility, 9-177, 
INITT Function 


IEFSSNxx Member 
9-178 
CTTTPI Utility, 9-186 


Subsystem List, 5-5 
CTTVTM Utility, 9-196 
Inline Resource Option 


IFLTSTA 
CTVDELI Utility, 9-94, 
AFP Printing, 4-39 
Profile Variable (CTM), 
9-95 
INOUT Attribute 


2~42 
Examples, 9•104 
Global Variable Member 
IGNORE Statement 
Field Names, D-1 
CCT0),.5.13 
CTil Daily Processing, 
Format (CTT), 9"102 
INP Parameter 
4-12 
Record Selection (CTT), 
CTTDLD Utility, 9-122,. 
IOACLRES Utility, 9"7 
9-102 
9-123; 
u 
IOALDNRS Utility, 9~35 
Record Selection Logic, 
INPUT Attribute 
Program CTMFRM, 3;.11 
9-102 
Global Variable Member 


IGNORE/SELECT 
Increasing. See Enlarging 
(CT0),.5-13 


Statements 
Index 
Inquire/Update Screen 
CTM Daily Processing, 
CTD Reports, 4-37 
(CTT) 


3-10 
Index File 
Profile Variable, 2~41 
IGXMSGEX Exit 
Deleting from1 DASD, 
Installation· and 
Cartridge Message 
9•94 
Customization Engine. See 


Display, 7-33 
Integrity (CTT), 9•120 
ICE 
IMM:::: 
IOA Access Method,.2"27, 
Installation Working Date, 


AFP Command,.4-41 
9~86 
4-8 
Immediate Printing 
Media Database, 7-12; 
IN-TABLE Parameter 
Archive Server, 4-66 
9-109 
Utility CTMBGRP, 9-43 


IMS 
Parameters (CTT), 9-112 
Integrity 


Color Support, 2~45 
Printing (CTT), 9-121 
Access Method Index, 


IMS/DC 
Rebuild Stacking Index, 
9-30 


Color Support, 2"25 
9-118 
Data Files (CTT), 9-119 


IOA Online Support, 2-1 
Rebuilding (CTT),. 7-24 
Index Files (CTT), 9-120 


IN Parameter 
Stacking Statistics File, 
IOA Access Method, 9-29 


Backup Missions, 4-52 
7-18 
Media Database, 7-9, 


Migration Missions, 4-57 
Index Reco11d 
7-19, 9-127, 9-132; 9•172 


Printing Missions, 4-34 
CTTIOS Macro, 7-49 
Rule Activity File (CTB), 
Types, 7-13 
9~67 
IN THE ROBOT Status Bit 
Indexing Reports 
Variable Files (CTB), 
IBM Robot Support, 7-26 
ACIF Interface, 4-44 
9-61 
u 
Integrity Error 


Correction, 7-20 
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INTENS Parameter 
Profiles, 2•31 
IOACMEML Member 
Display Format Member, 
Utilities, 9•1 
CMEM Rule List, 5-25 
2-25 
I0A Access Method, 1-7 
Rule Table List (CMEM), 


Inter System 
Dual Mirror Image Files, 
3-27, 5-3 
Communications (CTM), 
2-30 
IOACND Utility 
3-32 
File Allocation,.2•28, 9-18 
Manage 
Interface 
File Definition, 2'-30, 9-19 
Conditions/Resources, 


CONTROL-T to MVS, 7-2 
File Formatting, 9-18 
9-10 
CTM andCTD, 4-27 
File Recovery, 4-83 
IOACOPRS Utility 


CTRto CTT, 7-43 
File Structure, 2'-27 
Copy/Resize Cond/Res 


Interfaces 
Files (CTB),.2-29 
File, 9-14 


CA-7 (UCC7), 4-28 
Files (CTD), 2"29 
Restore 
Internal Data Aveas 
Conditions/Resources 


CONTROL-0, 5-17 
Index Integrity, 9-30; 
File, 3-26 
9-86 
INTERVAL Command 
Index of CTD Files, 9-86 
IOACPLOG Utility 


CMEM, 3-30 
Integrity, 9-29 
Copy Log File, 9-16 


CONTROL-D Monitor, 
Loading Files, 9-31 
IOADBF Utility, 9-50 


4-2 
Naming Conventions, 
Access Method Files, 9-18 


CONTROI'..-M Monitor, 
2~28 
IOA Access Method1 2~29 


3-2 
Overview, 1-7, 2-27 
IOADBSR Utility 


CONTROL-0 Monitor, 
Printing Files, 9-32 
Sort Access Method Files, 
5-15 
Recovery, 2-31, 9-27 
4-83,9-25 
INTERVAL Pavameter 
IOADCPY Utility 
IOADBSR Utility, 9-26 
Sorting Files, 4-83, 9•25 
Access Method File 
u 
INTRDR DB Statement 
Unloading Files, 9-33 
Recovery, 9-27 


CONTROI!.-M Monitor, 
Utilities, 2-29 
CONTROL-D File 
3-25 
Utilities (CTB), 9•4 
Recovery, 4-83 


Inventory Report 
Utilities (CTD), 9•3 
IOA Access Method, 2•30 


Vault Management, 9-194 
Variable File (CTB), 9-24 
IOADEST Member 


Invoking CONTROL-B, 6-6 
IOA Core 
Destination Table, 2-49 


Utilities, 9-4 
Description, 1-7 
IOADESTJ Member, 2c49 


IOA 
IOA Log 
IOADFLTC Member 


Ad hoc Maintenance, 8-4 
Copying, 9-16 
Updating, 2~46 


Application Program 
IOA LOG File 
IOADIG Utility 


Names, A-1 
Expanding, 2-50 
Access Method File 


Color Support, 2-24, 2'-25 
IOA Menu' See Primary 
Integrity, 9-29 


Customizing Screens, 
Option Menu 
IOA Access Method, 2-29 


2•17 
IOA Online. See Online 
IOADI[ Utility 


Dataset Formatting 
Facility 
Access Method Index 
Utilities, B-1 
IOA Resouvces 
Integrity, 9•30 


Display Format Members, 
Mirror File, 3c26. 
IOA Access Method, 2-29 


2c20 
IOA Screen Definition 
IOADLD Utility 
Dynamic Destination 
Constant Blocks, 2•18 
IOA Access Method, 2-30 


Table, 2-49 
IOA5DZN SMP/E Zone, 8-1 
Load Access Method 
Introduction, 1-1 
IOABLCAL Utility, 9-1 
Files, 9-31 
Limited Access, 2-8 
IOACI.:.RES Utility, 4-29 
IOADPT Utility 


Online Monitor 
Clean 
IOA Access Method, 2-30 


Activation, 2c5 
Conditions/Resources 
Print Access Method 
u 
Periodic Maintenance, 
File, 9•7 
Files, 9•32 


8-3 
CONTROL-M 
IOADUL Utility 


Maintenance, 3-6 
IOA Access Method, 2-30 
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Index 


\ 


Unload Access Method 
IOAX009 Exit 


: 
l 
---J- 
\J 
Files, 9-33 
Problem Determination, 


IOAEXSMP Member 
2'-7 
Japanese 


SMS Managed Tape 
IOAXTSO CLIST 
Language Support, 8-2 
Library, 7-26 
Entry to Online Facility, 
J8L 


IOAFRRES Utility 
2-2 
Editing via ISPF, 2-46 
Restore 
IOERPRM Keyword 
JC!::LEXPDT Keyword 
Conditions/Resources 
Volume Record, D-6 
Dataset Record, D-4 
File, 3-26 
IOERPRMC Keyword 
JDEPARMS Member 
IOAINSJ Member 
Volume Record, D-6 
Sample DJDE 


IOA Maintenance, 8-8 
IOERTMP Keyword 
Pa11ameters, 4-43 


IOAIPLCM Member 
Volume Record, D-6 
JES 


CMEM Rule List, 5-1, 5-7 
IOERTMPC Keyword 
IPL Automation (CTO), 


IOAISPF CLIST 
Volume Record, D-6 
5-5 
Entry to Online Facility, 
IOEWPRM Keyword 
JES2 
2-2 
Multi-Chunk Printing, 
IOALDNRS Utility, 4-29 
Volume Recoxid, D-6 
4-35 


CONTROL-M 
IOEWPRMG Keyword 
JES2'-DEST Printer 


Maintenance; 3;.6 
Volume Record, D-6 
Setting, 4-37 
Manual Conditions File, 
IOEWTMP Keyword 
JES3 
9-35 
Volume Record, D-6 
Multi-Chunk Printing, 
Manual' Conditions List, 
IOEWTMPC Keyword 
4-36 
4-3 
Volume Record; D-6 
JES3-CLASS Printer 


Multiple Runs (CTM),. 
IPI:. 
Setting, 4-37 
3-15 
Automation (CTO), 5-5 
Job 
u 
IOANOTE Utility 
CONTROL-0 IPL 
Dependency on CTD 


Sending a Message, 9-38 
Process, 5-8 
Report, 4-25 


IOAONL CLIST 
Starting CONTROL-0, 
Job Ordering 
Entry of Online Facility, 
5-1 
CONTROI1-M, 3-4 


2•2' 
IPLRULES Member 
Job Rerun 


IOAPROPJ Member 
CONTRC>L-0 Rule List, 
Profile Variable (CTM), 
IOA Maintenance, 8-7 
5-7 
2•37 


IOASPARM Member 
IRMA 
Job Rerun Screen 


Migration Media 
Color Support, 2•26 
Profile Variable (CTD), 


Definition, 4-59 
ISCALLOC Member 
2-37 


IOATEST Utility 
Inter-System 
Job Scheduling 


Simulation, 9-39 
Communications, 3-33 
Category Field, 4-26 


IOATSO CLIST 
ISCPARM Member (CTM), 
Job Statistics 


Entry to Online Facility, 
3-33 
Utility CTMJSA, 9-49 
2-2 
ISPF 
Job.Status Screen 
IOAVERFY Utility, 9-41 
Color Support, 2•25 
Profile Variable (CTM), 
IOAVMON 
Editing J8L, 2•46 
2•38, 2-44 


Operator Command; 2-7 
Entry to Online Facility, 
Job Step 


VTAM Monitor, 2•7 
2•2' 
Invoking CONTROl!.-B, 


IOAX007 Exit 
Online Facility Members, 
6-7 


Customization, 3-35 
E-12 
Job Step Invocation 


Inter-System 
ISPFBOTL 
CONTROL-B, 6-8 


Communications (CTM), 
Profile Variable, 2-43 
Job Submission 


3-33 
CTMAJO routines (CTD), 
u 
4-33 
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u 


JOBBBDMJob 


Rebuild Access Method 
Variable File, 9"24 
JOBBDBMJob 


CTBDBIB Utility, 9-53 


JOBBDBV Job 
CTBDBIB Utility, 9-53 
Rebuild Access Method 
Variable File, 9•24 
JOBBGRPJob 


CTBDBIB Utility, 9-53 
Rebuild Group· File, 9-24 


JOBBJAFJob 


CTBDBIB Utility, 9•53 


Rebuild Rule Activity 
File, 9•24 
JOBBREPJob 


CTBDBIB Utility, 9-53 
Rebuild Report File, 9-24 


JOBFABFJob 


Format Active Balancing 
File, 9-24 


JOBFBKPJob 


Format Backup File, 9-24 


JOBFGRPJob 


Format Group File, 9-24 


JOBFJAFJob 


Format Rule Activity 
File, 9-24 


JOBFMOD Job 


IOA Access Method 
Variable File, 9"24 
JOBFREPJob 


Format Report File, 9"24 
JOBFVARJob 


Format IOA Access 
Method Variable File, 
9-24 


JOBID Keyword 
Trace Record, D-11 


JOBNAME Parameter 
CTTGVL Utility, 9-125 


IGNORE/SELECT 


Statements (CTM), 3~11 


Jobs Dependency Network 
File 
Expanding (CTM), 3-36 


-K- 


KANJI Parameter 


@FIELD Display Format 
Line, 2"23 
KEEPDSN Parameter 


CTDDELRP Utility, 9-81 
Key. See Index 
KEY Parameter 
CTTIOS Macro, 7-49 
Keyed Access 
API' Interface,. 7-52 


KEYFROM Parameter 


IOADPT Utility, 9•32 


KEYLEN Parameter 
CTTCRDF Utility,. 9-112; 
9-117 
CTTDBF Utility, 9-117 
CTTIOS Macro, 7-50 
IOADBF Utility, 9-22 


KEYTO Parameter 
IOADPT Utility, 9-32 
Key-Type 
Media Database Index, 
7-12 


KEYTYPE Parameter 


CTTIOS Macro, 7-50 


Keywords 
Dataset Records, D-2 
Stacking Records, D-10 


Trace Data, D-12 
Trace Records, D-11 


Volume Records, D-6 
KEYxxx Members 


PARM library, 9-118 


KOilAK OPTISTAR 


Storage System. See OSS 


KODAK/DataWare OSS 
Updating, 4-67 


KSL Utility 


Mission Scheduling 
(CTD), 4-16 


-L- 


LABEL Parameter 


CTTGVL Utility, 9-126 
Exit CTDX005, 4-50 
LABTYPE Parameter 
CTTTPI Utility, 9-187 
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LACCDT Keyword 


Volume Record, D-6 
LACCJBN Keyword 


Volume Record, D-6 
LACCTM Keyword 


Volume Record, D-6 
Language Support 
10A Products, 8-2 
Laser Printers 


Index 


AFP Printing,.4-38 
LAST Parameter 
CTTDLD Utility, 9-123 
LASTACCS Keyword 
Dataset Record, D-4 


LBLNUM Keyword 


Volume Record, D-6 


LBLNUM Parameter 


CTTMUP Utility, 9-137 


LBLROUTC Parameter 
Modification (CTT), 7-4 
LBL TYP Keyword 


Volume Record, D-6 
LCLNDT Keyword 


Volume Record, D-6 
LDSFEET Keyword 


Volume Record, D-6 
LENGTH Parameter 


CTTRPT Utility, 9-148 
Limited Access. See 


Security. See 
Customization 
LINECMD Parameter 


Automation Option 


Menu, 5-19 


LINESIZE Parameter 
CTTACP Utility, 9-107 
CTTRPT Utility, 9-145 
LINK Command 
CTTGVL Utility, 9-125 
LIST Parameter 
CTTRTM Utility, 9-167 


IOAVERFY Utility, 9-42 


LOADGLOBAL Command 
Global Variable Members 


(CTO), 5-14 
Loading. See also item or 
feature to be loaded 
CMEM Rules, 3-27 
Global Variables (CTO), 


5-12 
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Index 


I0A Access Method Files 
-M- 
Media Database 
v 
9•31 
' 
Media Database, 9-115 
MParameter 
Access via Base Level 


Stacking Statistics File 
IOADBF Utility, 9•18 
API, 7-51 


9-115 
' 
10ADBSR Utility, 9-25 
Adding Volumes, 9-122 


LOADTREE Command 
Main Menu. See Primary 
API Access, 7-4 7 


IOA Online Monitor, 4-3 
Option Menu 
Backup and Recovery, 


Recipient Tree Loading 
MAINDAY Scheduling 
7-23 


(CTD),.4-3 
Table 
Backup Utility, 9•192 


LOCATION Keywovd 
CTM, 3-6 
Checking Integrity (CTT) 


Volume Record, D-6 
Customization, 3~ 13 • 
7-9 
' 


LOCSEQ Keyword 
Maintenance 
Converting Volumes, 9-122 


Volume Record, D-7 
Active Jobs File, 9-45 
Creation, 9-111 


LODOSSDB Job 
Ad-hoc, 8-4 
Daily Backup,.7-9' 


OSS Database Update, 
CONTROJ;.-D, 4-7 
Deleting Volumes, 9-122 


4-68 
Periodic, 8-3 
Enlarging, 7-21 


Log. See IOA Log. See 
Report List Files, 4-79 
ExLM Access, 7-31 


Automation Log 
User Reports List File 
Formatting, 9-113, 9-117 


LOG Command 
4-82 
' 
Index Integrity, 9-120 


Automation Log (CTO), 
Maintenance Jobs 
Integrity, 7-19, 9•119, 


5-12 
CONTROJ;.-M, 3~6· 
9-127, 9-132 


CMEM, 3-29 
Management Class 
Keyed. Access (API), 7-55 


Log File 
Adjusting, 7-38 
Loading, 9-115 


Copying the IOA Log, 9-16 
DF/SMS Support, 7-37 
Manual Update, 7-21 


Logical Field Names 
Manual Conditions 
Merge Utility, 9-129 
u 
CTT Repository, D-1 
Default Date, 2•42 
Non-Keyed Access, 7-58 


Logical Recovery 
Profile Variable, 2•38 
Printing, 9-121 


Description,. 7-25 
Reloading (CTD), 4-3 
Rebuild Index, 9-109 


MediaDatabase, 9-139 
Manual Conditions List 
Record Types, 7-10 


vs. Physical Recovery, 
Building, 9-35 
Recovery, 7-20; 9•139 


7-25 
Utility IOALDNRS, 4-29 
Selective Recovery, 7-25 


LOGSIZE Parameter 
Manual Update 
Split/Merge Process, 
9-172 
IOA Log File, 2•50 
Media Database, 9-131 
LONG Pavameter 
Mapping 
Statistics, 9-127 


@LINE Display Format 
Media Information, 9-180 
Structure, 7-9 


Line, 2-22 
MARGINS Parameter 
Unloading, 9•116 


LREC Parameter 
CTTRPT Utility, 9-145 
Update Utility, 9-131 


CTTCRDF Utility, 9-112 
Mask Characters 
Updates, 7-17 


LRECL Keyword 
INCLUDE/EXCLUDE 
Utilities, 9~5, 9-6 


Dataset Record, D-4 
Statements, 9-102 
Media Definition 


LRECL Parameter 
MAXCONN Parameter 
CART Media, 4-67 


Exit CTDX005, 4-51 
FileTek Media, 4-68 
FileTek Storage Machine, 
4-68 


IOADBF Utility, 9-22 
MAXUSERMVS 


LTH Parameter 
Parameter, 2•6; 4-4 
Migration Mission, 4-59 


@FIELD Display Format 
MDBUPDAT Parameter 
Media Information 


Line, 2~22 
CTTTPI Utility, 9-185 
Display, 4-72 


@STYLE Display Format 
Media Capacity 
Tape Mapping,.9-180 


Line, 2~21 
CART Media, 4-60 
MEDIA Keyword 


L-type Index 
Media Control 
Volume Record, D-7 
u 
Media Database, 7-13 
Archive Server, 4-69 
Media Management 


CART Media, 4-60 
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MEDIA Parameter 
CTD1401', 4-5 
Migration Skeletons,.4-60 
\._) 
CTTDl!.D Utility, 9•123 
CTD1601, 4-3 
MIGRATE IN PROCESS 
CTTTPI Utility, 9-187 
CTD271I, 4-5 
Status 


MEMBER Parameter 
CTD426W, 4-6 
Migration Mission, 4-62 


IGNORE/SELECT 
CTD427W, 4-6 
Migrated User Report List 
Statements (CTM), 3-11 
CTD428W, 4-6 
Backup Utility, 9-87 
MEMNAME Member 
CTD533S, 9-68 
Cleaning, 9-93 


CTD Scheduling, 4-23 
CTD7751,,.4-1 
CTDDELRP Utility, 4-78 


MEMOREX TELEX Tape 
CTD779I1, 4-4, 4-6 
Description, 4-77 


Library 
CTDF63W, 9-68 
Migration Mission 


CONTROL.-T Interface, 
CTMlOOI, 3~1 
Abends, 4-62' 
7-32 
CTM1071, 3~1 
Decollation Dependency, 
Memory Requirement 
CTM1201 
1 
, 
3~1 
4-57 
IOA Online, 2-4 


CTM123I,.3~2 
Dual Migration, 4-59 


Menu, See also Primary 
CTM2271, 4-2 
Exception Handling, 4-62 
Option Menu 


CTM2311, 4-5 
Media Definition, 4-59 


MENU Member, 2-15 
CTM645I,. 2"6 
Overview, 4-56 
Menus 


CTM6461\ 2c6 
Scheduling,4-13; 4-56 
Automation Options 


CTM717E, 2c40 
Scheduling Dates, 4-57 
(CTO), 5-19 
CTM777l, 2c5. 
Skeleton Job Parameters, 
Merging 
4-58 
MDB Records, 9-129 
CTM7781, 2c5 


Workflow, 4-57 
Message 
CTM7861, 4-3 
Mirror Image File 


Color of Display, 2'-39 
CTM7AOI, 2-8 
CONTROL-M Monitor, 
( 
Modification, 2-4 7 
CTM7 All, 2-8 
3-26 
\J 
Message Display 
CTM7 ACI, 2~8 
Recovery, 9•27 


Cartridge Tape 
CTM7BOI, 2-8 
Support, 2-30 
Subsystems, 7-33 
CTM7Bll, 2-8 
Mission 


MESSAGE Parameter 
CT01231, 5.-16 
Scheduling 


CTMMMSG Macro, 2-4 7 
CT01471, 5-8 
Workflow, 4-17 
Message Statistics Facility 
CT015IH, 5-18 
Workflow, 4-17 
(CTO), 5-9 
CT01841, 9-98 
Mission List Members 
Copy Statistics File, 9-98 
CT0189l, 9-98 
(CTD), 4-14 
Profile Variable, 2c37 
CT0240W, 5-10 
Mission List Screen (CTB) 


Report Utility, 9•99 
CT0241E, 5-10 
Profile Val'iable, 2-43 
Message to Log File 
CT0251I, 5-16 
MISSION Pa11ameter 
IOANOTE Utility, 9-38 
CT0297I, 5-11 
Invoking CONTROL-B, 


Messages 
CTT200S, 7-51, 7-71 
6-7 
CME123I, 3~30 
IOAlOBI, 4-6 
Mission Scheduling 
CME150l, 3~32, 5·18 
10A128I, 4-73 
CONTROL-D, 4-12 
CME15DI, 3~32 
MF Parameter 
Manual, 4-16 
CME251I, 3-30 
CTTI0S Macro, 7-50 
Migration Missions, 4-57 


CTDlOOl,.4-1 
MIGCART Member 
Production Control 


CTD1071, 4-4, 4-5 
Migration Skeleton, 4-60 
Systems, 4-27 
CTD113W, 4-6 
MIGDASD Member 
Restore Missions, 4-63 


CTD12011, 4-4 
Migration Skeleton, 4-60 
MODE Installation 


CTD1231, 4-2 
MIGORDER KSL Utility 
Parameter 


CTD1301, 4-37 
Migration Missions, 4-16 
Modification (CTT), 7-4 
u 
CTD1361, 4-4 
MIGRATStep 
MODE Parameter 


CTD1391,4-l 
Migration Mission,.4-58 
CMEM Rule, 3-29 
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CTDCLHIS Utility, 9•76 
CTDDELRP Utility, 9-80 


CTTDLD Utility, 9-123 
CTTIDB Utility, 9-128 
CTTINIT Procedure, 7-3 
CTTMER Utility, 9-129 


CTTMUP Utility, 9-131 


CTTPARM Member, 
9-165 


CTTRCV Utility, 9-140 


CTTRTM Utility, 9•166 
CTTSPL Utility, 9-175 
CTTSTK Utility, 9-177 


CTTTPI Utility, 9-184 


CTTUDB Utility, 9-193 
CTTVTM Utility, 9-195, 
9-196 
CTVDELl Utility, 9~94 


Rule Operation (CTO), 
5-12 
Modification. See 
Customization 
Monitor 
CMEM, 3~3, 5-25 


CONTROL-D, 4-1 
CONTROL-M, 3:.1 
CONTROb-0, 5·25 
IOA Online, 1-5, 2:.3, 2"4, 
2"5 
IOA Products, 1-5 
Replacing (CTO), 5-2' 
Sleeping Interval (CTD), 
4-2 
Sleeping Interval (CTM), 


3~2 
VTAM, 2:.7 


Mount Messages 
Modification, 7-2 


MOVEDATE Keyword 
Volume Recoiid, D-7 
Moving 
Database Records, 9-172 
MRGIN Parameter 
Utility CTTMER, 9•129 
MSGCLASS Parameter 


Held Output Class 


(CTM), 3:.25 


MSGFMT Parameter 


Modification (CTT),. 7-4 
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MTU Parameter 
CTTIDBUtility, 9-127 


CTTUDB Utility, 9-193 
Multi Chunk Method 
Bundle Printing, 4-35 
JES2;.4-35 
JES3; 4-36 


Multi-CPU Sites 
Inter-System 
Communications (CTM), 


3:.32' 


Multi-Volume Chain 
Chain Link Evror, 9-127 
Manual Update, 7-21 


RTNTYPE Parameter, 
9-164 


Volume/Ilataset Records, 
7-16 
Multi-Volume Dataset, 7-15 
MVS 
ASVT, 2'-6, 4-4 
Catalog Conversion, 


9-123 
Interface (CTT), 7-2; 7-4 


IPt. Automation (CTO), 


5-5 
MVS Gateway for 
Enterprise Controlstation. 
See ECSGATE 


-N- 


NAME Parameter 


@FIELD Display Format 
Line, 2-22 


CTTRPT Utility, 9-145 
Migration, Media, 4-59 
Naming Conventions 
IOA Access Method; 2-28 
NBLKS Parameter 


CTTCRDF Utility, 9~111 


New Day Procedure 


Changing Time, 3:.24 
CONTROL-B, 6-1 
Mission Scheduling, 4-14 
Scheduling Generic 
Missions, 4-21 
Starting, 4-6 
New Day Processing 


Conditions/Resources 


(CTM/D), 4-29 


CONTROL-D, 4-6 


CONTROI:.-M, 3-4, 4-23 


CONTROL-T, 7-7 


CTDCA2P, 4-76 
Description, 1-6 
Implementation (CTM), 


3:.9 
Programs (CTD), 4-10 
Programs (CTM), 3-16 
Rule Refresh Option 


(CTT), 7-8 
Sample Components 
(CTM),.3-5 


NEWAJF File Statement 


Utility CTM8AJF, 9-47 


NEWCONLIST Command 
CMEM, 3,28 


NEWDEST Command 


Destination Table, 2:.49 
NEWGLOBJob 


Global Library 


Compressioni 5-15 
NEWNAME Parameter 
CTTMUP Utility, 9-134 
NEWRES Parameter 
IOACOPRS Utility, 9-15 


NEWSECDEF Command 
CMEM, 3,30 
CONTROL-0 Security 


Cache, 5,16 
NEWSNC Parameter 
IOACOPRS Utility, 9-15 


NEXTVOb Keyword 
Volume Record, D-7 
Night Plan Report 


Production Control 


Systems, 4-28 


NLASKOP Parameter 


Modification (CTT), 7-4 
NOCHECK Parameter 
OSS Migration, 4-61 


NOFORCE Parameter 
CONTROL-0 Procedure, 


5-2 


NOINDEX Parameter 
CTDDELRP Utility, 9-81 
Non-Keyed Access 
Base Level API (CTT), 


7-53 
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f 
( \__.,) 
NOPRINT Parameter 
One-Chunk Method 
F IOASMON,DISPLAY 
CTBJAFDh Utility, 9-65 
Bundle Printing (CTD), 
MEDIA=, 4-72 


NOREPORT Parameter 
4-35 
F IOASMON,SET 
CTDIJ>ELRP Utility, 9•81 
One-Outgroup ·Method 
DEBUG=, 4-73 
Normal Mode 
Bundle Printing, 4-36 
F IOASMON,START 


CONTROL-T, 7-5 
Online Facility 
MEDI:A, 4-69 


NOSEP JES Parameter 
Command Customization, 
F IOASMON,STOP 


Multi-Chunk Printing, 
C-1 
MEDIA, 4-69 


4-35 
Command Modification, 
F 


NOTOK Status 
2-13 
CONTROLD,INTERVAL, 


Cross Memory Interfaces, 
4-2 
Backup.Missions, 4-56 
F 
2-1 
Migration Mission, 4-62 
Cross-Reference of 
CONTRObD,LOADTREE, 
NOTRST Parameter 
Options, E-1 
4-3 


CTDBELRP Utility, 9-80 
Customization, 2•8 
F 


NOTWD Parameter 
CONTROLD,STARTGEN, 
CTDilELRP Utility, 9•80 
Entry, 2•2 
4-1, 4-22 


NRECS Parameter 
Environments, 2-1 
F 


CTTCRDF Utility, 9-111, 
New Recipient Tree, 4-3 
CONTROLD,STARTPRT, 


9-117 
PFKey Definition,.2•13 
4-37 


CTTDBF Utility, 9•117 
Online Monitor 
F 


Null Values 
Balance Workload, 2"5 
CONTROLD,STOPGEN, 


CTTMUP Utility, 9•137 
Deactivation, 2-6. 
4-4, 4-22 


Description, 1-5, 2-3 
F CONTROLD,STOPPRT, 
NUMBTAPE Parameter 
4-37 
CTTTPI' Utility, 9-187, 
IOA, 2"4, 2"5 
F 
\_) 
9-188 
Number of Users, 2•5 
CONTROI1M,INTERVAL, 
NUMERR Parameter 
Online Viewing 
3-2 


CTTTPI Utility, 9-188 
Archive Server, 4-66 
F 


NUMGEN Parameter 
OPEN Function, 
CONTROI:.M,NEWCONLI 


CTBDBVCG Utility, 9-55 
Base Level API· (CTT), 
ST, 3-28 


CTBDBV8P Utility, 9-57 
7-47 
F CONTROLO, 


Opening. See Starting 
LOADGLOBAL, 5-14 
Operating Status 
F 
-0- 
Parameters (CTT), 7-4 
CONTROLO,AUTOlJOG, 


ODATE 
Operation Mode 
5-10 


CTDCA2P Utility, 4-76 
Checking (CTT), 7-8 
F CONTROLO,D=, 5-5 


CTDCP2A Utility, 4-76 
CMEM, 3"29 
F CONTRObO,DEBUG=, 


Migrated Report List, 
CONTROL-0 Rules, 5-12 
5-17 


4-77 
Dormant (CTT), 7-4 
F CONTROI;.0,LOG=, 


5-12 
Mission Scheduling, 4-17 
Normal (CTT), 7-5 
F 
Utility CTMJSA, 9-49 
Suspended (CTT), 7-5 
CONTROLO,NEWSECDE 
OFFSET Parameter 
Operator Commands 
F, 5-16 
@FIELD Display Format 
F CONTROl!.O, 
F 
Line,.2-23 
C=library(table), 5-4 
CONTROl'..0,0=ALL,REB 
OLDAJF File Statement 
F 
UILD, 5-9 


Utility CTMCAJF, 9-47 
CONTROLO,INTERVAL= 
F 


OLDRES Parameter 
'5-15 
CONTROLO,RESETSTA 
IOACOPRS Utility, 9•14 
F CONTROhO,O/F, 5-3 
T, 5-9 


OLDSNC Parameter 
F 
F CONTROLO,SNAP, 
u 
IOACOPRS Utility, 9-15 
CTMCMEM,INTERVAL=, 
5-17 


3-30 
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F 


CONTROLO,STARTSTAT 


'5.9 
F 


CONTROLO,STARTSTAT 


s, 9-98 
F 


CONTROLO,STOPSTAT, 


5.9 
F 


CONTROLO,STOPSTATS 


'9-98 
F 


CONTROLO,WATERMA 


RKS, 5-18 
F 


CONTROLO,WRITEGLO 


BAL, 5·12 


F 
CONTROLx,NEWDEST, 


2"49 


F CTM8MEM, C=, 3~27 


F CTMCMEM,D=, 3~28 


F CTMCMEM,DEBUG=, 
3-31 


F CTMCMEM,DISPLAY, 


3-29 
F CTMCMEM,LOG=, 


3-29 
F 


CTMCMEM,NEWSECDE 


F, 3~30 


F CTMCMEM,SNAP, 


3-31 
F CTMCMEM,STOP, 3-3 
F 


CTMCMEM,WATERMAR 


KS, 3~32 


F 


IOAOMONx,LOADTREE, 


4-3 
F IOA VMON,D, 2~8 


F 
monitor _name,DISPLAY, 
2-6 


P CONTROLM, 3-1 


P CTMCMEM, 3~3 
P IOAOMONx, 2-8 


P monitor_name, 2"6 
S IOASMON,DEBUG=, 


4-73 


S CONTROLM, 3-1 
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S CONTROLO,DEBUG=, 


5-17 
s 


CONTROLO, TYPE=CTO 
CMEM, 5-26 


S CTMCMEM, 3-3; 3-27 


S CTMCMEM,DEBUG=, 


3-31 


S CTTINIT, 7-2 


S IOAVMON, 2-7 
Operators 


INCLUDE/EXCLUDE 


Statements, 9-102 


Optical Disk 
Migration Missions, 4-61 
Optical Library Dataserver 
Migration,Skeleton, 4-61 


Optical Storage System, See 
oss 


Option Code 


Customization, 2-10 
OPTION Parameter 


Automation, Option 
Menu, 5-19 
Options 


Primary Option Menu, 
2"16 
OPTISTAR Storage System. 
See OSS 
OPTLIST Parameter 
Automation Option 


Menu, 5-23 
ORDER Parameter 


CONTRO:t-0 Procedure, 
5-2 
Rule Lists (CTO), 5-7 


Rule Table Loading 
(CTT), 7-6 


S CTMCMEM Command, 


3~27 


oss 
Archive Server, 4-66 
Stopping/Starting a 
Device, 4-69 


OSS Database 
Adjustments to,Migration 


Skeleton, 4-60 


Migrationof Extract DB, 
4-61 


Updating, 4-67 


OSSDBEXT Step 


OSS Migration, 4-60 
OSSDBVL Parameter 


OSS Migration, 4-61 


Ol!JT Parameter 


Decollation, Missions, 
4-34, 4-52; 4-57 
Job Dependency, 4-25 


OUTDD Parameter 
CTTRPT Utility, 9-146 


OUTGRO"C!JP Parameter 


CONTROl!.-D Chunks, 
4-38 


OlJTGRP Parameter 
Bundle Printing (CTD), 
4-35 


Ol'.JTLIST Parameter 


CONTROL-0 


Initialization, 5-1 


OllJTPARMS Library 
Global Printing 
Characteristics, 4-4 7 


OUTP'l'.JT CDAM Parameter 


AFP Printing, 4-39 


O'WTPUT Statement 


AFP Printing, 4-38 


CTTACP Utility, 9-106 


Printers Control Monitor 
(CTD), 4-38 


O'WT-TABLE Parameter 
Utility CTMBGRP, 9-43 


OVERJCL Parameter 
Modification (CTT), 7-4 
Overlays 


AFPDS Printing, 4-43 
Overriding 
Allocation Member, 2c12 
OWNER Parameter 


CTTTPI' Utility, 9•187 


-P- 


P Option 


Active Missions Screen, 
4-37 
Packaging 
IOA, 8-1 


Page Break 


AFP Printing, 4-39 
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' u 
Page Markers 
PGM Parameter 
Presentation Mode 


AFP Printing,.4-40 
Transaction Member, 2"9 
Profile Variables, 2-43 
Page Mode Output 
PGM8Tx Member 
PREVVOL Keyword 


AFP Printing, 4-39 
Program List Member, 
Volume Record, D-7 


Page Segments 
2"10 
Primary Extent Dataset 


AFPr>S Printing, 4-43 
Physical Recovery 
IOA Access Method, 2-28 
PAGEDEF Parameter 
Media Database, 7-24, 
Primary Key 


AFP Printing, 4-38 
9-139 
CTTRPT Utility, 9•143 
CDAM, 4-39 
vs .. Logical Recovery, 7-25 
Primary Option Menu 


PAGESIZE Parameter 
Platter Prefix 
Customization, 2-15 


CTTRPT Utility, 9•145 
Migration Missions, 4-61 
Description, 1-3 


PaneL See Screens 
PNRSDTYP 
Format, 2-14, 2-16 
Parameters 
Profile Variable, 2-42 
PRIMARY Parameter 


ACIF, 4-44 
Pool 
1 Definition 
CTDUPBKP Utility, 9-89 


CDAM, 4-39 
CA-ASM2 Support, 7-36 
Exit CTDX005, 4-51 


CTTINIT Procedure, 7-2 
DD Statement (CTT), 7-5 
Print Destination 
DJDE (XEROX Printers), 
Initializing (CTT), 7-3 
Activ:e User Report List, 
4-42 
Pool Definitions 
4-76 
Migration Media, 4-59 
HSC Scratch Pools, 7-31 
Report List Files, 4-75 
Migration Skeleton, 4-58 
Post Processing Parameters 
PRINT Parameter 
Restore Skeleton Job, 
Backup.Missions, 4-55 
CTBJAFDL. Utility, 9-65 
4-64 
Migration Missions, 4-58 
PRINTED Status 
PARM Parameter 
Restore Mission, 4-65 
Active Report List, .4-77 
u 
Automation Option 
Postscript Output 
PRINTED-WAIT BKP 
Menu, 5-21 
AFP Printing, 4-40 · 
Status 
CTMMMSG Macro, 2"4 7 
PREF Parameter 
Active User Report List, 
PARMLIB Parameter 
@FIELD Display Format 
4-77 


IOADBSR Utility, 9-25 
Line, 2-22 
Printer Control 
PASSWORD Parameter 
PREFIX Parameter 
Bundle Printing (CTD), 


FileTek Media, 4-68 
CTDCCU Utility, 9-74 
4-34 


PDATELTH 
Exit CTDX005, 4-50 
PRINTER Parameter 


Profile Variable, 2-40 
Prerequisite Condition 
Bundle Printing (CTD), 


Periodic Maintenance 
Adding/Deleting/V erifyin 
4-35 


IOA Products, 8-3 
g, 9-10 
Opening/Closing Printers, 


Permanent Report List 
Backup· Mission 
4-36 


Copy from Active, 9•72 
Dependency, 4-52 
Printers 


Copy to,Active, 9-77 
Date Related Erasure, 
AFP Printers, 4-38 


Permanent User Report 


3~10 
Opening/Closing, 4-36 


List 
Deleting, 9-7 
XEROX, 4-42 


CTDCA2P Utility, 4-76 
Description, 1-8 
Printers Control Monitor 


CTDCP2A Utility, 4-76 
Inter-System 
Activation CTD, 4-1 


Description, 4-75 
Communications (CTM), 
New Day Processing, 4-6 


3~32 
Ol:JTPUT Statement, 4-38 
PF03·Function Key 
Job Dependency, 4-28 
XEROX Printers, 4-43 
Profile Variable, 2•42 
Manual Conditions, 4-3 ·. 
Printing. See also Printers 
PFKey Definition, C-1 
Migration Mission, 4-57 
Control Monitor 
Format,.2•13 
Migration Skeleton, 4-58 
Data File (CTT),.9•121 
Modification, 2-13. 
Printing Mission 
Database Records (CTT), 
u 
PFKey Members 
Dependency, 4-34 
9•121 
Online Facility, E-1 
Global Control, 4-4 7 
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Index File (CTT), 9•121 
PROTECT Parameter 
10ADUL Utility, 9-33 
u 
IOA Access Method Files, 
CTTTPI Utility, 9-184 
RBAOFS Parameter 
9-32 
PROTECTED Attribute 
IOADBSR Utility, 9•25 


MediaDatabase, 9•121 
Global Variable Member 
RBTTYPE Pa11ameter 


Stacking Stacking File, 
(CTO), 5-14 
MEMOREX Tape Library 
9-121 
PRTDBG D]j) Statement 
Support, 7-32 
Printing Mission 
Archive Server 
Modification· (CTT),. 7-4 


AClF Parameter Member, 
Procedure, 4-73 · 
Robotic Library Support, 
4-45 
CMEM Procedure, 3~31 
7-26 


CHUNKSIZE Parameter, 
CONTROL-0 Procedure, 
RC Parameter 
4-35 
5-17 
CTTIOS Macro, 7-49 
Decollation Missions, 
PRTLIST Member 
READ Function 
4-34 
Printing Missions, 4-14 
Base Level API (CTT), 
Overview, 4-30 
PRTMON# Parameter 
7-47, 7-51 
Profile Variable, 2"36 
Printing Missions, 4-33 
READCC Keyword 
Scheduling, 4-13 
PRTORDER KSL Utility 
Dataset Record, D-4 
Scheduling Dates, 4-34 
Printing Missions, 4-16 
READCPU Keyword 
Workflow, 4-31, 4-37 
PSCHDTYP 
Dataset Record, D-4 
Printing to a File 
Profile Variable (CTM), 
READDDN Keyword 
Exit CTDX005, 4-49 
2"40 
Dataset Record, D-4 


PRIVATE Parameter 
PTF Level 
READli>IDT Keyword 
Exit CTDX005, 4-50 
ExLM Support (CTT), 
Dataset Record, D-4 
Production Control System 
7-31 
Reading Files 


CTDRRQ Program, 4-28 
PZUMFAPP 
API' Interface (CTT), 7-51 
u 
PROF Parameter 
Profile Variable (CTM), 
READJBN Keyword 


Profile Attributes, 2"34 
2"41 
Dataset Record, D-4 
Profile 
PZUMFGRUP 
READNEXT Function 
Description, 2-31 
Profile Variable (CTM), 
Base Level API (CTT), 


Members, 2-32 
2•41 
7-47, 7-52 


Profile Member Format, 
READPGM Keyword 
2-33 
-Q- 
Dataset Record, D-4 
Saving a Profile Member, 
QNAME Parameter 
READSTEP Keyword 


2"35 
CTTMUP Utility, 9•135 
Dataset Record, D-4 
Profile Variables. See also 
Quantitative Resource 
READTM Keywo11d 
specific variable 
Adding/Deleting/Modifyin 
Dataset Record, D-4 
Color Support, 2•39 
g, 9"10 
READlJAD Keyword 
Modification, 2"35 
Description, l-8 
Dataset Record, D-4 
PROG Parameter 
READVOL Function 
CTTTPI' Utility, 9-186 
-R- 
High Level API, 7-68, 
Program List Member 
7-69 
Default Members, 2-10 
RANGE Statement 
Real-time Environment 


IOA Customization, 2-9· 
CTTDLD Utility, 9•123 
CONTROl!.-T, 7-1, 7-4 


Program Names 
RBA 
Termination (CTT), 7-6 
IOA Applications, A-1 
Media Database, 7-10 
Reason, Codes 
PROGRAM Parameter 
RBAKeyword 
High Level APl; 7-71 
Automation Option 
Trace Data, D-12 
Macro CTTIOS, 7-49 
Menu, 5·20 
RBA Parameter 
REBUILD Option 
PROMPT Parameter 
CTTIOS Macro, 7-49 
CMEM Facility, 3-28 


\ u 
Automation Option 
RBAOFF Parameter 
Rule Loading (CTO), 5-4 
Menu, 5-21 
IOADPT Utility, 9-32 
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Rebuilding 
RECVLNUM Keyword 
Report List Files 
Access Method Variable 
Volume Record> D-7 
Active, 4-76 
File (CTB), 9-24 
Reformatting 
CTDCP2A Utility, 4-76 


CTB Index, 9-52 
Active Balancing File, 6-2 
History, 4-78 
Group File (CTB), 9-24 
Refreshing 
Management (CTD), 4-74 
Report File (CTB), 9-24 
CMEM Security Cache, 
Permanent User Report, 
Rule Activity File (CTB), 
3-30 
4-75 


9•24 
Rule Definitions (CTT), 
Summary, 4-79 
REC Parameter 
7-8 
Workflow (Diagram), 4-80 
CTT10S Macro; 7-49 
Relative Byte Address. See 
REPORT Statement 
RECAT Parameter 
RBA 
CTTRPT Utility, 9-145 


CTTRCV Utility, 9-141 
RELOAD Mode 
CTTRTM Utility, 9-169 
RECDEL Statement 
CTTINIT Procedure, 7-3 
CTTVTM Utility, 9•197 
CTTMUP Utility, 9-134 
Reloading 
Report Status 
RECFM Parameter 
CONTROb-T Rules, 7-8 
Active User Report List, 


APAPARM Library, 4-40· 
Recipient Tree, 4-3 
4-76 
Dataset Record> D-5 
User Exits (CTT), 7-3 
Report Utilities 


Exit CTDX005; 4-51 
REMFEET Keyword 
CONTROL-B, 9-4 


RECFROM Keywovd 
Volume Record, D-7 
Repository 


Volume Record,.D-7 
RENAME Parameter 
Backup and Recovery 
Recipient Tree 
CTTDLD Utility, 9-123 
(CTT), 7-23 
Loading via IOA, 4-3 
Repeating Step 
Disaster Recovery, 7-24 
Reloading (CTD), 4-3 
Restore Mission, 4-64 
IOA Products, 1-9 
u 
Record Selection Logic 
REPLACE Parameter 
Overview (CTT), 7-9 


INCLUDE/EXCLUDE 
CTBDBVCP Utility, 9-56 
Recovery Methods (CTT), 
Statements 
Replacing 
7-25 


CTT Utilities, 9-102 
CONTROI:.-0 IPI:, 
Selective Recovery (CTT), 
RECOVER Statement 
Monitor, 5-8 
7-25 


CTTRCV Utility, 9•140 
REPLIST Member 
Rerun 


Recovery 
Decollating Missions, 
Migration Missions, 4-62 


Access Method Files, 4-83. 
4-14 
RESETSTAT Command 


CONTROI:.-M, 3~19 
REPORDER KSL Utility 
Message Statistics (CTO), 


CONTR01"-T, 7-20 
Decollating Missions, 
5.9 


CONTROL-T Repository, 
4-16 
RESIDENT Parameter 


7-23 
Report 
CTVDELI Utility, 9•95 


CTTRTM Utility, 9-163 
Deleting (CTD), 9-79 
RESLOT Parameter 


CTTTPI' Utility, 9-182 
Dependency on CTM Job, 
CTTVTM Utility, 9-196 


IOA Access Method,.2-31 
4-25 
Resource Control 


MDB from Trace File, 
Printing to a File, 4-49 
Archive Server, 4-69 


9-139 
Scratch.Report (CTT), 
Resouvce Information 
Media Database, 7-24 
9•162 
Display, 4-72 


Selective (CTT), 7-25 
Report Decollating .. See 
Resource Utilization 


Split/Merge Process 
Decollating Mission 
CMEM, 3~32 
(CTT), 9-173 
Report File ( CTB) 
CONTROL-0, 5-18 
RECREATE Parameter 
Formatting, 9-24 
RESTART Parameter 
Modification (CTT), 7-4 
Rebuilding, 9-24 
CTTRTM Utility, 9-167 


RECTYPE Keywo11d 
Report Generation (CTT) 
CTTVTM Utility, 9-195 
u 
Trace Data, D-12 
CTTRPT Utility, 9-143 


RECUPD Statement 
Sample Reports, 9•154 


CTTMUP Utility, 9-135 
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RESTORE IN PROCESS 
RETURNS Parameter 
Rule 
u 
Status 
Automation Option 
Automatic Loading 
Restore Mission Abend, 
Menu, 5-22 
(CTO), 5-2 
4-65 
RETVLTFT Keywol'd 
CTB Activation, 6-4 
Restore Mission 
Volume Record, D-7 
Deactivating (CTO), 5-5 
Default Missions, 4-15, 
RLSE Parameter 
Loading (CMEM), 3-27, 
Exception Handling, 4-65 
Exit CTDX005, 4-51 
5.3 


History User Report List, 
RMM 
Loading (CTO), 5-3 
4-78 
Conversion Utility, 9-123 
Loading (CTT), 7-6 
Overview, 4-62 
Robot Suppol't 
Operation Mode (CMEM), 
Post Processing 
COMPAREX, 7-25 
3-29 
Parameters, 4-65 
EMASS, 7-32' 
Operation Mode (CTO), 


Profile Variable, 2-36 
HDS 745017430; 7-25 
5-12 
Scheduling, 4-13 
IBM Robots, 7-26 
Refreshing (CTT), 7-8 
Scheduling Dates, 4-63 
MEMOREX TELEX, 7-32' 
Scheduling (CTO), 5-8 


Skeleton Job Pa11ameters, 
StorageTek Silo, 7-28 
Rule Activity File (CTB) 
4-64 
Formatting, 9-24 
Workflow, 4-63 
Robotic Support 
Rebuilding, 9-24 


RESTORED Parameter 
CONTR01'-T, 7-25 
Rule List 


CTDr>ELRP Utility, 9-80 
Roll Back Recovery 
DD Statement (CTT), 7-5 
Media Database, 7-25, 
Restoring 
9•139 
Rule List Member 
Media Database, 7-24 
Roll Forward Recovery 
Multiple Lists (CMEM), 
RESUME Mode 
MediaDatabase, 7-24, 
5-7 
CTTINIT Procedure, 7-5 
9-139 
Multiple Lists (CTO), 5-7 
u 
RESWPF3· 
ROSCOE 
RULE Pa11ameter 


Profile Vamable, 2-42 
Color Support, 2c45 
Invoking CONTROI!.-B, 


Retention' Criteria 
Cross-Memory Interface, 
6·7 
CTTMUP Utility, 9-137 
2cl 
Rule Status Screen (CTO), 


Retention Management 
RONT Parameter 
5-9 


CTR Interface to CTT, 
IOATEST Utility, 9-39 
Rule Table 
7-43 
RPF 
Date, 7-6 
CTTRTM Utility, 9-162 
Mission Scheduling 
Loading (CTT), 7-3, 7-6 
New Day Procedure 
(CTD/V), 4-16 
Rule Table List 
(CTT), 7-8 
RSTLIST Member 
Profile Variable, 2-43 
Retention Period 
Resttore Missions, 4-14 
RULEINFO Parameter 
Backup Mission (CTD), 
RSTORDER KSL Utility 
CTTMUP Utility, 9-131 
4-56 
Restore Missions, 4-16 
RULELIST Member 


CTDCLHIS Utility, 9-76 
RSVNONRMVS 
CTO Rule List, 5-25 
CTr>DELRP Utility, 9•80 
Parameter, 2c6, 4-4 
Format (CTO), 5-2 


CTVDELI Utility, 9-95 
RSVSTRT MVS Parameter, 
RULER Parameter 
Migrated Report List, 
2-6, 4-4 
Exit CTDX005, 4-51 


9•93 
RTNFROM Keyword 
RULLIST Member 


RETPD Parameter 
Dataset Reco11d1 D-5. 
CTTINIT P11ocedure, 7-3 


CTDNPBKP Utility, 9-89 
RTNTYPE Parameter 
Format (CTT), 7-6 


RETRO Parameter 
CTTPARM Member, 
RUNTCACH Parameter 
Decollating Scheduling, 
9-164 
Security Cache (CTO), 
4-14 
RTNUPD Parameter 
5-16 
Return Codes. See also 
Modification (CTT), 7-4 
Runtime Envi11onment 
( 
) 
Specific Program or Utility 
(CTB) 
\.....-! 
High Level API, 7-70, 
Invoking, 6-5 
7-71 
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-S- 
Screen Definition 
SEPDS JES2 Parameter 


SABKWND 
Constant Blocks, 2-18 
Multi-Chunk Printing, 


Profile Variable (CTD), 
Macros, 2"17 
4-35 


2-36 
Profile Attribute, 2-34 
Sequential File 


SAMAWND 
Screen Members 
IOA Log, 9-16 


Profile Variable (CTD), 
Online Facility, E-1 
Printing to; 4-49 
2-37 
Screen Modification 
Sequential Read 
SAMDELI 
Recommended Stages, 
Media Database, 7-53 
Profile Variable (CTD), 
2"19 
SER Parameter 
2-37 
Screens 
CTTTPI Utility, 9-186, 
SAPRWND 
Customization, 2" 17 
9-188 
Profile Variable, 2-36 
Primary Option Menu, 
Server. See Monitor 
SARSWND 
2-14 
Shared DASD (CTM), 3-32 
Profile Variable (CTD), 
SCRPROT Parameter 
Shared Spool (CTM), 3c32 
2c36 
Modification (CTT), 7-4 
Shout Facility 
Saving. See feature or value 
SDECWND 
Dynamic Destination 
to be saved 
Profile Variable (CTD), 
Table, 1-11, 2-49 


SBALTBO 
2-36 
Show Screen Filter 


Profile Variable (CTB), 
SDENSir.I'Y Keyword 
Profile Variable (CTM), 


2-43. 
Stacking Record, D-10 
2•42 
SCHEDBLE TAG Field 
SDWYCNA 
SHOW Window Filters 
Utility CTMBGRP, 9-43 
Profile Variable (CTD), 
Profile Customization, 
Scheduling 
2"37 
2-34 
u 


Balancing Missions, 6-2 
SEARCH Parameter 
SHOWBLINE Parameter 


CONTROL-M, 4-26 
Decollating Missions, 
@LINE Display Format 


CONTROL-0 Rules, 5-8 
4-76 
Line, 2"22 


CTDand CTMWorkflow, 
Secondary Extent Dataset 
Shutting Down. See 


4-23 
IOA Access Method, 2"28 
Deactivation 


CTD Missions, 4-13 
SECONDARY Parameter 
SIMULATE Parameter 


Scheduling Facility. See 
CTDUPBKP Utility, 9-90 
Utility CTDUPBKP, 9-89 
also Calendar Facility 
Exit CTDX005, 4-51 
Simulation. See also MODE 


Calendar-based Rules 
Migration Mission, 4-59 
Parameter 
(CTT), 7-8 
SECPREF Parameter 
CTDCClJ Utility, 9-74 


Scheduling Tables 
Dual Migration, 4-59 
CTVDELI Utility, 9•94 


Regular to· Group 
Security 
IOATEST Utility, 9-39 
Conversion, 9-43 
CMEM, 3~30· 
SIMULATION Parameter 


SCOPE Parameter 
Description, 1-12 
CTDCCU Utility, 9-74 


CONTROL-B Missions, 
Security Cache 
SINSLMT 
6-10 
Profile Variable (CTT), 


SCRATCH Parameter 
Refreshing (CTO), 5-16 
2•41 
CTTDI>D Utility, 9•123 
SELECT Statement 
Size 
Scratch Pools 
Program CTMFRM, 3c11 
Active Missions File, 


HSC/CSC Support, 7-31 
Selection Criteria 
4-81, 9-68 


Scratch Report 
INCLUDE/EXCLUDE 
Active Transfer File, 


CTTRTM Utility, 9-162 
Statements (CTT), 9-102 
4-81, 9-70 


Fields, 9-170 
Selection· Group. See 
Automation Log, 5-11, 


INCLUDE/EXCLUDE 
9-100 
Scratch Volumes 
Statements 
Conditions/Resources 


' 
Daily Report, 7-8 
Selective Recovery 
File, 9-14 
u 
SCRDT Keyword 
Media Database, 7-25 
CONTROL-M Files,. 3-35 
Volume Record,.D-7 
Media Database, 7-21 
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Trace File (CTT), 7-22 
SMSGWRN 
SQFILE Parameter 
u 
Skeleton, Job 
Profile Variable, 2:.39' 
IOADLD Utility, 9-31 
Backup Mission, 4-54 
SMSINTR Parameter 
I0ADUL Utility, 9-33 
Migration Missions, 4-57 
CTTPARM Member, 
SRCFILMT 


Printing Missions, 4-32 
9-165 
Profile Variable, 2:.42 · 


Restore Mission, 4-64 
DF/SMS Support, 7-37 
SRCMTBO 
SKELETON Parameter 
Modification (CTT), 7-4 
Profile Variable (CTM), 


Printing Mission, 4-32 
SMSMC Keyword 
2-43 


Sleeping Interval 
Dataset Record, D-5, 
SREPTBO 
CMEM, 3:.30 
SNAP Command 
Profile Variable (CTD),. 
CONTROI!.-D, 4-2 
CMEM, 3-31 
2'-43 


CONTROL-M, 3~2 
CONTROL-0, 5.17 
SRESCND 


CONTROL-0 Monitor, 5-15 
Snapshot 
Profile Variable (IOA), 


SLNAME Keyword 
CTT Database Files, 
2:.38 


Volume Reco11d, D-7 
9-121 
SRESDRNG 


SLNFPAG 
SNRSCNE 
Profile Variable, 2:.42 


Profile Variable (8TD), 2:.40 
Profile Variable (IOA), 
SRLDATO 


Slot Numbers 
2-38 
Profile Variable (CTT), 


Vaulted· Volumes, 9• 196 
SNRSDRNG 
2-44 


SLOTNUM Keyword 
Profile Variable, 2:.42 
SRVD Step 


Volume Recoiid, D-7 
SOLVHFC 
OSS Migration, 4-60 


SLSUX:Ol User Exit 
Profile Variable, 2:.39 
sseHBR0 


HSC/GSC Job·Processing, 
SOLVOCL 
Profile Variable, 2-40 


7-31 
Profile Variable, 2:.40 
SSCHTBO 
0 
SMF 
SObVSCL 
Profile Variable (CTM), 


Type 15 Records, 9:.177 
Profile Vaciable, 2:.40 
2-44 


SMF Accounting 
SOMPTBO 
SSTACNS 


CONTROL-D, 4-84 
Profile Variable (CTO), 
Profile Variable (CTM), 
2-43 
2-37 


SMISTBO 
SORTBY Statement 
SST ALTO 


Profile Variable (CTD), 
CTTRPT Utility, 9:.147 
Profile Variable (CTM), 
2-43 


CTTRTM Utility, 9-170 
2-44 


SMNAME Parameter 
SSTAWND 


FileTek Media, 4-68 
CTTVTM Utility, 9•198 
Profile Variable (CTM),. 
SMP/E 
Utility CTORSTM, 9-99 
2:.37 
IOA Maintenance, 8-4 
SORTIN Statement 
SSTDELl 
SMP/E Modules 
OSS Migration, 4-61 
Profile Variable (CTM), 
IOA Packaging, 8-1 
Sorting 
2:.38 
SMS Managed Tape 
Access Method,Files, 9-25 
SSYVORD 


Library 
Active Report List, 4-83 
Profile Variable (CTR), 
IBM Robot, 7-26 
Active User Report List, 
2-40' 
SMSCWND 
4-82 
SSYVSCL 


Profile Variable (CTO), 
SPACE Parameter 
Profile Variable (CTR), 
2:.37 
IOADBF Utility, 9•20 
2-40 
SMSGERR 
SPACETY Parameter 
SSZMWND 


Profile Variable, 2-39 
Exit CTDX005, 4-51 
Profile Variable (CTM), 


SMSGINF 
Split/Merge Process 
2:.38 


Profile Variable, 2-39 
Description' (CTT), 9•172' 
Stack File. See Stacking 


SMSGSVR 
Merge Utility, 9-129 
Statistics File 
\ 
l 
Profile Variable, 2:.39 
STACKID Parameter 
\...._) 


CTTGVL Utility, 9-125 
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Stacking Facility (CTT) 
STARTSTK Mode 
STKOBS Field 
Activation, 7-41 
CTTINIT Procedure, 7-5 
Stacking Statistics File, 
GDGs, 7-42 
STARTTIME Parameter 
7-18 
Interface Utility, 9•125 
Utility CTOALOCP, 
STKPGM Keyword 


Overview, 7-39 
9-100 
Stacking Record, D-10 


Starting, 7-5 
START-WHEN-OVER 
STKPRED Field 
Stopping, 7-5 
Parameter 
Stacking Statistics File, 
Testing, 7-41 
IOADBSR Utility, 9-26 
7-18 
Statistics. See Stacking 
STKSRCHL Parameter 
Utilities, 9-5 
Statistics. See Message 
Modification (CTT), 7-4 
Stacking Record 
Statistics 
Stacking Search, 7-40 
Keywords, D-10 
CONTROL-M Jobs, 9-49 
STKSTAMP Field 
Stacking Statistics File, 
Media Database, 9-127 
Stacking Statistics File, 
7-41 
Message Statistics File, 
7-18 
Build/Update Utility, 
9-98 
STKTEST Parameter 
9-177 
Statistics File (CTM) 
Modification (CTT), 7-4 
Creation, 9-111 
Expanding, 3-36 
STKTIME Keyword 
Daily Update, 7-8 
Statistics File (CTO), 5-9 
Stacking Record, D-10 
Formatting, 9-113; 9-117 
Full Conditions, 5·10 
STKUNIT Keyword 
Index Integrity, 9~120 


Unnecessary 
Stacking Record, D-10 
Integrity, 9-119 
Enlargement, 5-9 
STKVOLl Keyword 
Loading, 9-115 
STATS Rule Table (CTO), 
Stacking Record, D-10 
Printing, 9•121 
5-10 


Rebuild Index, 9•118 
STATUS Parameter 
STOP Parameter 


CTTTPI Utility, 9•189 
u 


Structure, 7-17 
CTMCAJF Utility, 9-46 


STOPGEN Command 
Unloading, 9-116 
IGNORE/SELECT 


Decollation Deativation, 
Utilities, 9•6 
Statements (CTM.), 3~12 


4-5 
START Function 
STEPLIB DD Statement 
Generic Processing 
High Level API', 7-68, 
CTDRRQ Program, 4-28 
(CTD), 4-22 
7-69 
STKBL.KCT Keyword 
STOPPRT Command 
STARTDATE Parameter 
Stacking Record, D-10 
Stopping a Printer, 4-37 
Utility CTOALOCP, 
STKBLKSZ Keyword 
STOPSTAT Command 
9-100 
Stacking Record, D-10 
Message Statistics (CTO), 
Started Task. See Monitor 
STKCOMPF Keyword 
5-9 
STARTGEN Command 
Stacking Record, D-10 
STOPSTATS Command 
Generic Processing 
STKDATE Keywoiid 
CTO Message Statistics, 
(CTD), 4-1, 4-22 
Stacking Record, D-10 
9-98 
Starting. See Initialization. 
STKDEFFT Parameter 
STOPSTK Mode 
See Activation 
Default Dataset Length, 
CTTINIT Procedure, 7-5 
Printers, 4-36 
7-40 
Storage Class 
Starting a New Day. See 
Modification (CTT), 7-4 
Adjusting, 7 -38 
New Day Procedure 


STKDSN Keyword 
DF/SMS Support, 7-37 
STARTPRT Command 
Stacking Record, D-10 
StorageTek Silo 
Starting a Printer, 4-37 


STKIND Keyword 
CONTROL-T Interface, 
STARTSTAT Command 
Message Statistics (CTO), 
Stacking Record, D-10 
7-28 
5-9 
STKJBN Keyword 
ExLM Support, 7-31 


STARTSTATS Command 
Stacking Record,.D-10 
HSC/CSC Scratch 
STKKEY Field 
Support, 7-31 
CTO Message Statistics, 
Stacking Statistics File, 
STRTCH Keyword 
l_j 
9-98 
7-18 
Stacking Record, D-10 
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Structure 
SUMTITLE Parameter 
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MediaDatabase, 7-9· 
CTTRPT Utility, 9"151 
Table List Screen 
Stacking Statistics File, 
Supervisor Calls. See SVC 
Profile Variable (CTM), 
7-17 
SUS2I:.MT 
2-44 
Trace File (CTT), 7-17 
Profile Variable (CTD), 
Tape Cartridge Subsystem. 
STUDBLC Keyword 
2"41 
See CART Media 
Stacking Record, D-10 
SUS2SRTI 
Tape Eject 
STUDBLKS Keyword 
Profile Variable (CTD), 
IBM Robot User Exit, 
Stacking Record, D-10 
2"41 
7-26 


STUDCMPF Keyword 
SUSPEND Mode 
Tape Entry 
Stacking Record, D-10 · 
CTTINIT Procedure, 7-5 
IBM Robot User Exit, 


STUDDEN Keyword 
Suspended Mode 
7-27 
Stacking Record, D-10 
CONTROL-T, 7-5 
Tape Erasure, 9-181 


STUDDSN Keyword 
SUSRDELW 
Tape Initialization, 9-179 
Stacking Record, D-10 
Profile Variable (CTD), 
Tape Library. See Robot 


STUDDTE Keyword 
2c38 
Support 


Stacking Record, D-10 
SUSRFTR 
Tape Mapping, 9-180 
Profile Variable (CTD), 
Tape Pool 
STUDJ0B Keyword 
2-44 
CTDCLHIS Utility, 9-76 
Stacking Record, D-10 
SUSRHDR 
Tape to Disk 
STUDPGM Keyword 


Profile Variable (CTD), 
Migration Skeleton, 4-60 
Stacking Record, D-10 
2"44 
Tape/CART Migration 
STUDRTCH Keywoiid 
SUSRVEW 
Skeleton Job· 
Stacking Record, D-10 
Profile Variable (CTD), 
Adjustments, 4-61 
\_) 
STUDTME Keywoiid 
2-44 
TAPEMAP Function 
Stacking Record, D-10 
SVC 
CTTTPI Utility, 9-188 
STUD'C!JNIT Keyword 
Installation (CTT), 7-4 
TAPEMS Parameter (CTR) 
Stacking Record, D-10 
SVC Number, 7-2 
Interface to CTT, 7-43 
STUDVOL Keyw.ord 
SVEWFFI 
TAPERAS Function 
Stacking Record, D-10 
Profile Variable, 2"41 
CTTTPl Utility, 9-188 
STUFLAG 1 Keyword 
SWHYCNA 
Target Media 
Stacking.Record, D-10 
Profile Variable (CTM), 
Migration Missions, 4-59 
SUB· Parameter 
2-38 
TBLT Parameter 
CONTROL-0 
Syntax 
CTTINIT Procedure, 7-3 
Initialization,. 5-1 
Rule Definitions (CTB), 
TCOI:.OR 
SUBSYS JCL Parame~er 
9•51 


Profile Variable, 2c45 
CDAM Files, 9-7 4 
SYSDATA (CTM), 3c25 
TCT. See Control Table 
Utility CTDDELRP, 9-82 
SYSBATA Entry 
(CTT) 
SUBSYS Parameter 
CTDDELRP Utility, 9-81, 
TCT Parameter 
FileTek Media, 4-68 
9-82• 


CTTIOS Macro, 7-49 
I0A Subsystem, 5-5 
SYSIN DD Statement 


TDBCS 
Subsystem Chains 
CTTTPI' Utility, 9-190: 


Profile Variable, 2c45 
Problem Determination, 
Utility CTMBGRP, 9•43 
TEMPORARY Attribute 
2-7 
Utility CTTTPI, 9•183 


Global Variable Member 
SUFFIX Parameter 
SYSLIB Library 
(CTO), 5-14 
Utility IOADCPY, 9~27 
Ad·hoc Maintenance, 8-8 
TERM Mode 
SUMMARY Parameter 
SYSPRINT DD Statement 
CTTINIT Procedure, 7-3 
CTTRPT Utility, 9•145, 
CTTTPI Utility, 9-190 
TERM Parameter 
9-146 
Utility CTMBGRP; 9•43 
IOATEST Utility, 9•39 
:..___,; 
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Terminal Characteristics 
TOTYPE Parameter 
TRCSUZE Parameter 
Double Byte Character 
Utility CTOALOCP, 
CTTPARM Member, 


Set, 2-45 
9-100 
9-108 


Termination 
TOUNIT Parameter 
Trace File Size, 7-22 


CONTROI:.-T, 7-6 
Utility CTOALOCP, 
TRCVOL Parameter 


TERMTYPE 
9•101 
CTTCTRC Utility, 9-114 


Profile Variable, 2•46 
TOVOI:.UME Parameter 
Tree. See Recipient Tree 
Testing 
Utility CTOALOCP, 
TRTCH Keyword 
Dynamic Dataset 
9-100 
Dataset Record, D-5 


Stacking, 7-41 
Trace Data 
TRTCH Parameter 


TESTRUL Parameter 
Keywords, D-12 
Exit CTDX005, 4-51 


CTTPARM Member, 
Trace File 
TSO 


9-165 
Backup, 7-23 
Color Support,.2-45 
Time 
Backup Utility, 9•192 
Cross-Memory Interface, 
Time-Dependent Actions, 
Copying, 9-106 
2;.2 


3-23 
CTTRTM Utility, 9•166 
Entry to Online Facility, 
TIME Keyword 
CTTVTM Utility, 9•195 
2-2 
Trace Record, D-11 
Enlarging, 7-22 
TYPE Parameter 


TIMEFROM Parameter 
Formatting/Creating, 
@STYLE Display Format 


IOADBSR'Utility, 9•25 
9•114 
Line, 2-21 


TIMEOUT Parameter 
Formatting/Initializing, 
CONTROL.-0 Monitor, 5-8 


Printing Mission, 4-32 
9-108 
CTTACP Utility, 9-106 


Timestamp 
MDBRecovery, 9-139 
CTTRCV Utility, 9-140 


\_) 
CTTSTK Utility, 9-177 
Structure ( CTT), 7 -17 
IOADBF Utility, 9•19 


Migration Skeleton, 4-58 
Utilities, 9-5 
Migration Media, 4-59 


TIMETO Parameter 
Trace Modes 
TYPELIKE Parameter 


IOADBSR Utility, 9-25 
Rule Operation (CTO), 
@STYLE Display Format 
TITLE Parameter 
5-12 
Line, 2;.21 
CTTRPT Utility, 9-145, 
TRACE Parameter 
TYPERET Statement 


9-148 
CTTRTMUtility, 9-166 
CTTRTM Utility,·9-167 
TMSCTLEX Exit 
CTTVTM Utility, 9-195 
TYPERUN Statement 
DMS Tape Volume Exit, 
Trace Record' 
CTTBIX Utility, 9-109 
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Keywords, D-11 
CTTDLD Utility, 9.-123 


TO Parameter 
TRANID Parameter 
CTTIDB Utility, 9-128 


CTMCAJF Utility, 9-46 
I0AONL CLIST, 2•2 
CTTMER Utility, 9-129 


CTTACP Utility, 9-106 
Transaction File 
CTTMUP Utility, 9-131 


CTTDBPRT Utility, 9-121 
CTTIDB Utility, 9-128 
CTTRTM Utility, 9-166 


TODATE Parameter 
Update MDB, 9-193 
CTTSPL Utility, 9•174 
Utility CTMJSA, 9-49 
Transaction ID 
CTTSTK Utility, 9-177 


Utility IOACP:tOG, 9-16 
IOA Online, 2•2 
CTTTPI Utility, 9-184 


TOilSN Parameter 
Transaction Member 
CTTUDB Utility, 9-193 


Utility CTOALOCP, 
I0A Customization, 2'-8 
CTTVTM Utility, 9•195 
9-100 
Predefined (Reserved) 
Utility CTTMUP, 7-21 


TOGEN Parameter 
Members, 2-9 
TYPEVLT Statement 
CTBDBVCP Utility, 9-57 
TRCBLKS Parameter 
CTTVTM Utility, 9-196 


TOKEY Parameter 
CTTCTRC Utility, 9-114 


IOAD'NL Utility, 9-33 
TRCIN Parameter 
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TORECNUM Parameter 
CTTACP Utility, 9-106 
Utility CTOALOCP, 
TRCOl!JT Parameter 
UNCTLG Parameter 


9-101 
CTTACP Utility, 9-106 
CTTRTM Utility, 9-168 
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UNDIDRSCORE Attribute 


Profile Variable; '2-45. 
UNIT' Parameter 


ExitCTDX005,.4-50···: 
IOADBF Utility, 9•19 
Utilitilb.ADCPY';''9-27 
UNITD'Parameter' -'' 
,j@ADBF Utility, 9•19 
UNITNAME Parameter 
Migration ·Media, 4.59· 


Vol~~e·Recol:id, D-7 · 
Unloading 


IOA Access Method Files, 


9-33;,.'.J . ·,,: ' 
:. 


Media Database, 9~116 
Stiickixig Statistics File, 


,'·9;,.J.16 
UNMATCH Pa~aineter 
C'PDUP,BKP'Utility, 9-90 


. liJpdating! <:· · 


Global Variables (CTO), 
5-12"!• .. '."';• . 
•.' .. " 
MDB':Volume, 9-132 · 
Mediii'Database, 9~131, 
9-193··· .. " 
Stacking Statistics File, 


9~i!r7~ . 


UPI'>QNM Statement 


C'.J:'.TM:µP Utility, 9-135 


UPDTVOl. Function 


Hi~.~:~evel API,.7-68, 
7-69 


UPI'>VOL Parameter 
CTTR'I\M Utility: 9~169 
ft - 
··- 
. 
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J?rofll~ Varl~ble, 2~4~ 


Us~ Att~ibute 
IBI\4; J;tobc°t:U~erExit, 


7-2~-C :··-c,, 
USEDAYS, f>arameter .· 


. C'l;''.l'IPB .Utility, ~-128 
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User Daily 


. CONT]tOL.-D, ~-7 . 
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Pf>~'E~9:t·M, 3:;f;,, 


. Date Control.Reco11d 
'·· · c6trh' 4-8'· 


~ r , 'lr .• 
Scheduling (CTM), 3~13 


~} .. ( ' 
'\ 
,·. 
Work Flow (CTM); 3-17 


Us~~ Qaily C,CTJ)), 4~1'9 


User Exit. See also Exits · 


Reloading (CTT), 7-3 


User Groups 


CONTR01'-D, 4-22· 1••• 
User Profile, 2'-32:.See,also 
Profile 
· 
User Report: See Report · 
User Reports List File · 


Maintenance, 4-82; ~ 
USERDATA Keyword. 


Volume Record; D-7 


USERID Keyword 
Trace Record;'D-11 
Users 


Multiple Users (IOA), 2•5 
Utilities. See;also Specific 
Utility 
. · 1 
CTBABI, 9~50·1' 
CTBCMP, 9-51. 2 ']: ; 
CTBDBIB, 9-52 · 
CTBDBVCG, 9.-!54 
CTBDBVCP,; 9-56 


CTBDBVDL, !;)~59 
CTBDBVIG, 9-61 


CTBJAFCP, 9-63 


CTBJAFDL,';9~65 
CTB.:TAFIG, 9-67 I 
CTDAMUTl, 9-2 


CTDCA2P;'4•76; 9.72· 
CTDCAMF, 9-68 
r ; ·. 
CTDCATF; 9-70 
CTDCCU, 9-74 


CTDCLHIS, 4-79, 9-76 


CTDCP2A, 9-77 


CTDIDELRP, 4-78, 9-79 


CTDDIB, 9-86 


CTDSMFRP, 9•3 . 


CTDUPBKP, 9-87 


CTMBGRP, 9-43 


CTMCAJF, 9-45 .. 
CTMJSA, 9-49 


CTOALOCP, 5-11, 9-100 
CTOCSF, 5-10; 9-98 


CTORSTM, 9-99 


CTTACP, 7-23; 9-106 
CTTAFR, 9-108 
.. 


CTTBIX, 7-20; 7-24, 


9•109 
CTTCRDF, 9-111 


CTTCTRC, 9-114 


CTTDBDI:.D, 9-115· 
CTTDBDUL,. 9-116 


CTTDBF, 9-117 


CTTDBIB, 9-118 


CTTDBID, 7-24, 9~119 
· CTTDBII, 9•120 
CTTDBPRT, 9-121 


CTTDLD, 9-122 


CTTGVL, 9-125 


CTTIDB, 7-9, 7-20; 9-127 


CTTMER, 9-129 


CTTMUP, 7-21, 9•131 
CTTRCV, 7-24, 9-139 


CTTRPT, 9-143:, 
CTTRTM, 7-8, 9-162 


CTTSPL, 9-172 


CTTSTK, 7-8, 7-41, 9-177 


CTTTPI, 9"179 
CTTTRB, 9-192 


CTTUDB, 9-193 


CTTVTM, 7-8, 9-194 


CTVCLMIG, 9-93 


CTVDELI, 9-94 
Dataset Fo11matting, B-1 
IEBGENER 7_9,,'ff' 
, 
IOA Access Method, 2'-29 
IOABLCAL, 9-1 
IOACLRES, 4-29, 9-7 


IOACND, 4-28, 9-10 
IOACOPRS, 9-14 


IOACPI:.OG, 9-16 
IOADBF, 9-18 


IOADBSR, 4-83, 9-25 


IOADCPY, 9-27 
IOADIG, 9•29 


IOADII, 9-30, 
IOADLD, 9-31 
IOADPT, 9-32 


IOADUL, 9-33 


IOALDNRS, 4-3, 4-29, 
9-35 


IOANOTE, 9-38 


IOATEST, 9-39 
IOAVERFY, 9-41 
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Validation. See Integnty · 


Validity 


Checking via 


CONTROI:.-B, 6-7 
Variable Generations 


Utility CTBDBVCG, 9-54 
Variable G11oups 
CTB Utilities, 9-4 
VARIABLE Pa11ameter 
CTBDBVCG Utility, 9-55 


CTBilBVCP Utility, 9-57 


CTBilBVDL Utility, 9-59 
Variables. See also· Profile 
Variables 
Global Variables (CTO), 


5-12 


Vault Definition 


Dil Statement (CTT), 7-5 
Initializing (CTT), 7-3 · 
VAULT Keyword 


Volume Record, D-7 


Vault Management 


CTTVTM Utility, 9•194 


New Day Procedure 


(CTT), !7-8 


VC~GED Keyword 


Volume Record, D-7 


VCHANGET Keyword 


Volume Record, D-7 


VCHANGEU Keyword 


Volume Record, D-7 


VDENSUI'Y Keywovd 
Volume Record, D-7 


VENDOR Keyword 


Volume Record, D-7 


VENDOR Parameter 


CTTDLD Utility, 9•123 
CTTTPl Utility, 9-187 
Verification 
File Installation and 
Status, 9-41 


VERIFY Mode . · 
CTTINIT Procedure, 7-4 


VERIFY Parameter 
10A VERFY Utility, 9-41 


VERIFY-IN-HISTORY 


Parameter 


CTDCCU Utility, 9-74 


VLTBYDSl Parameter 


CTTPARM, 9-194 
Modification (CTT), 7-4 


VLTDSNUM Keyw.ord 


Volume Record, D-7 
VLTENTDT Keyword 


Volume Record, D-7 
VLTENTNM Keyword 


Volume Record, D-7 


VLTEXPD'l'.Keyword 
Volume Record, D-8 


VLTEXTYP Keyword 


Volume'Record, D-8 


VLTPREFL Keyword 


Volume Record, D-8 


VOL. Parameter 


IOADBF Utility, 9-19 " 


Utility IOADCPY, 9•27 
VOLl Parameter 
Exit CTDX005, 4-50 
VOL2 Parameter 
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Exit CTDX005, 4-50 
VOLADD Statement . 


CTTMUP Utility, 9-132 


VOL.BIX Statement 
CTTMUP Utility, 9-133, 


9•136· ' '; 
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Exit CTDX005, 4-50 
VOL.D Pavaiheter 


IOADBF Utility, 9-19 


VOL.DEL Statement 


CTTMUP Utility, 9-132 


VOL.EDMID Keyword' 


Volume Record, D-8 


VOLEXCP Keyword 


Volume Record, D-8 


VOLEXPDT Keyword 


Volume Record, D-8 


VOLEXPTY Keyword 


Volume Record, D-8 


VObFEET Keyword 
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VOL.FLAG2 Keyword 


Volume Record, D-9 


VOLFLAGS Keyword 


Volume Record, D-8 


VOLIND Keyword 


Volume Record, D-9 


VOLQDESC Keywor-CJ.; :.· 'l:·. 
Volµme Record, D79 
VOLOWNER Keyword cu 
Volu;r;ne Recqrr;I;-I?:ri:h:·::.-.: 
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CTTMUP Utiltty; 9~l.32 
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" , , . -~.c. , " 
• 
VOI;.SNUM Keyword . , . 


Dataset, Record, D~5_ · · 
VOLSTAT Keyw.ord :'.::.;; 
Volume Record; n-;9;1 ·H 
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